Toggle navigation [p 11] 


@ [Nav] [p ??] 

© [GitublIp 771 

© [Versions] [p 221 
Oo [2.2][p 21] 
Oo [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [L.3][p 1767] 
O [1.2][p 2233] 

© [Feedback][p 2” 

e 


PF 


; p27 
: ip 2635] 

Hello World 

Application and RunLoop 

Updating Content 

Window Handling 

Unit Testing 

Packaging 

Mobile Packaging 

Distribution 

apr Metadata 

Cross ae 

Exploring Fyne][p ? 

Canvas and CanvasObject 

Container and Layouts 

Widget List 

Layout List 

Dialog List 

Handling Shortcuts 

Using the Preferences API 

System Tray 

Data Binding 

Sa Options 

Drawing and Animation|(p 22] 

Rectangle 

O Text 

O Line 

© Circle 


OO0O0O00000 0 


OO0O00000 0 


O 
O 
O 


(e) 


Image 
Raster 
Gradient 
Animation 


e [p ??] 
Box 


000000 0 


Grid 

Grid Wrap 
Border 
Form 
Center 
Max 
a 


+ [del 71 


OO0O0000 0 


abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 

Table 


Daa Bnd 71 


oO 
O 
O 
O 


© [introduetion][p 26471 
Binding Simple Widgets 
Two-Way Binding 

Data Conversion 

List Data 


e Extending Fynd|ip ” 


O00 0 


© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 


o rchestlip 7 


oO 
O 
O 


Geometry 
Scaling 
Widgets 


© {Organisation and Packages|[p 2656] 


@ |Frequently Asked Questions|[p ??] 


oO 


Layout and widget size 


O Customisation 

» (EPTDocamenaonie 
[Upgrade to v2.2||p 2665] 
° Fam aT 


[package fyne][p 211 
[Animation] [p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadata][p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjecT [p 2732] 
Clipboard] [p 2742] 
[Container|[p 2751] 

[p 2762] 

[Device][p 2771] 
[DeviceOrientation] {p 2780) 
[Disableable][p 2789] 
[DoubleTappable|[p 2798} 
[DragEvent][p 2807] 
[Draggable][p 2816] 
[Driver][p 2825] 
[Focusable]ip 2834] 
[HardwareKey][p 2843] 
[KeyboardShortcut][p 2852] 
[p 2861] 
[KeyModifiey|p 2870) 
[KeyName]|p 2879] 
[Layout|[p 2891] 

[Legacy Theme] {p 2900] 
[LifecyclelIp 2910] 
[ListableURI|[p 2919) 
[MainMenuJ[p 2928} 
[Menul[p 2937] 
[Menuttem]{p 2946] 
[Notification] {p 2956] 
[OverlayStack][p 2965] 
[PointEvent][p 2974] 
[Position] [p 2983] 
[Preferences [p 2993] 
[Resource][p 3003] 
[ScroflablelIp 30121 
[ScrofiEvend|{p 3021] 


[SecondaryTappablel[p 3030] 
[Settings|[p 3039] 
[p 3048] 
[Shortcutabie][p 3057] 
[p 3066] 
[ShortcutCul]fp 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste][p 3095] 
[ShortcutSelectAll|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validatoy|[p 3144] 
[Fabbable][p 3153] 
[Fappable|[p 3162] 
[TextAlign][p 3171] 
[TextStylel[p 3180] 
[p 3189] 
[Theme][p 3198] 
[ThemeCoforName][p 3207] 
[ThemelconName]{p 3216] 
[ThemeSizeName]{p 3225] 
[Theme Variant][p 3234] 
[URI] [p 3243] 
[URTReadCToser|{p 3253] 
[URTWriteCloser|[p 32621 
[Validatable][p 32711 
[p 3280] 
[Widget|[p 3289] 
[WidgetRenderer][p 3298] 

e [Window][p 3307] 
O [app][p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas|[p 3337] 

© [package canvas|[p 33371 

e |Circle][p 3347] 
[Image][p 3357] 
[imageFill][p 3369] 
[imageScalel[p 3378] 
[Line] [p 3387] 
[LinearGradient][p 3397] 
[RadialGradient][p 3408} 


[Raster ip 3419) 
[Rectangle|[p 3430] 
[Text][p 3441] 


o fontaine ip 34521 


package containey|[p 3452] 
[AppTabs][p 3464] 

[p 3476] 

Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split][p 3506] 

[p 3516] 
[FabLocation][p 3526] 


O [p 3535] 


package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList][p 3555] 

[Bytes|[p 3564] 
[BytesLisl|[p 3573] 
[Pataltem] {p 3582] 
[DataList][p 3591] 
[Datal-istener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBool]p 3618] 
[ExternalBoolLisi|[p 3627] 
[ExteralBytes][p 3636] 
[ExternalBytesLis|[p 3645] 
[ExternalFloat)[p 3654] 
[ExternalFloatlisi][p 3663] 
[Externaling][p 3672] 

[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[ExternalString][p 3708} 
[ExternalStringList|[p 3717] 
[ExternalUntyped][p 3726] 
[ExternalUntypedLisi|[p 37351 
[ExternalUntypedMap][p 3744] 
[ExternalURI][p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Int][p 3790] 

[IntList][p 3800] 


[Rune] [p 3809] 
[RuneLisf[p 3818) 
[String] [p 3827] 
[StringLis][p 3838] 
[p 3847] 
[Untyped] [p 3856] 
[UntypedList[p 3865] 
[UntypedMap][p 3874] 
[URI][p 3883] 

e [URIList|[p 3893] 
© [data/validation] |p 39021 

e [package validation]p 3902| 
O [dialog|[p 3912] 

© [package dialog|{p 3912) 

 [ColorPickerDialog][p 3923] 

© [ConfirmDialog|{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog|{p 3953] 

e 

e 


[FileDialog]{p 3963) 
[ProgressDialog][p 39741 

o [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop][p 3994] 

© [package desktop] {p 39941 

e [Appl[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie)p 4031] 
[CustomShortcul][p 4040] 
[Driver][p 4049] 
[Hoverable]{p 4058} 
[Keyable|[p 4067] 
[Modifier] [p 4076] 
[Mouseable][p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 

@ [StandardCursor|{p 4113) 
© [iriverimobilel[p 4123] 

© [package mobilel[p 4123] 

e [Device][p 4132] 

© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
@ 
e 


Touchable|[p 4159] 
[p 4168] 


© [iriver/software]Ip 4177] 

© [package software][p 4177] 
O [flayout][p 4187] 

© [package Tayout|ip 4187] 

e [Spacer|[p 4198] 

© [SpacerObject] ip 4209] 
O [storage][p 4218] 

© [package storage] [p 4218] 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

e [MimeTypeFileFilter|[p 4254] 
© Morageltepository][p 4263] 

© [package repository] [p 4263] 

© [CopyableRepository][p 42741 
[CustomURIRepository] [p 4283] 
[HierarchicalRepository|[p 4292] 
[ListableRepository][p 4301] 
[MovableRepository][p 4311] 
[Repository] |p 43211 
[WritableRepository][p 4332] 
O [test|[p 4341] 

@ [package test|[p 4341] 

 [SoftwarePainter][p 4354] 

© [WindowlessCanvay][p 4363] 
O [theme][p 4373] 

© [package theme][p 4373] 
[DisabledResource]{p 4409] 
[ErrorThemedResource][p 4418} 
[invertedThemedResource][p 4428] 
[Primary ThemedResource][p 4438] 
[FhemedResource][p 4448] 
O [widget|[p 4458] 
package widgell[p 4458} 
[Accordion]ip 4470] 
[Accordionltem|[p 4480] 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAlign]{p 4510] 
[ButtonfconPlacement]{p 4519} 
[Buttonimportance]{p 4528} 
[ButtonStyle][p 45371 
[Card] [p 4546] 
[Check|[p 4556] 


jon 


[CheckGroup]{p 45671 
[CustomTextGridStyle|[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[p 4621] 

[p 4632] 
[Hyperlink][p 4641] 
[HyperlinkSegment|[p 4653] 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment][p 4704] 

[p 4714] 
(Orientation) [p 4725] 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
[ProgressBarp 4766] 
[ProgressBarlnfinite|[p 4776] 
[RadioGroup][p 4786] 
[RichText][p 4796] 
[RichTTextBlock][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] [p 4846] 
[Separator|ip 4856] 
[SeparatorSegment|[p 4866] 
[p 4876] 

[Table][p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[TextGridRow]|p 4927] 
[TextGridStylel[p 4936] 
[FextSegment][p 4945] 
[Toolbar] [p 4955] 

[Toolbar ction] |p 4965] 
[Toolbarltem{p 49751 
[ToolbarSeparator|[p 4984] 
[ToolbarSpacer|[p 4993] 


e [Tree|[p 5002] 
@ |TreeNodeID|[p 5014] 
e [p 5023] 


Fyne toolkit documentation for developers 


This site is home to the documentation and examples for developers working with the Fyne toolkit. We 
have details for people just getting started, building their first graphical app through to detailed 
walkthroughs of complex topics related to building leading cross platform apps. 


If you can’t wait to start building your first Fyne app, you should follow our getting started guide. 


[p 2635] 
You can also check out the latest|API documentation|[p 5032] , or if you came here with a question in 
FAQs| 


mind then you may find an answer in the|FAQsj|[p 5033] . 


If you are new to the Go language, we recommend running through the Go tour before returning to the 
Fyne documentation. 


‘Take the Go Tour|[p ??] 
There is also an|introduction to GUI development|[p 5042] if this is your first time building an application. 


For developers who prefer to learn from videos we have a collection of getting started tutorials on 
YouTube. 


Tutorial Playlist}[p ??] 


If you have questions about the videos or want to let us know that one is missing then please 
[p ??]. 


Installing 
If you have not used Fyne before then the following steps will get you up and running: 


1. Install Go 
2. Install Gec 
3. go get fyne.io/fyne/v2 
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Installing 
If you have not used Fyne before then the following steps will get you up and running: 
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To explore more detailed topics you can check out the[explore| [p 5051] section of this site. If you would 
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If you like the Fyne toolkit please consider [sponsoring] [p ??] our work. 
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© [List My Applip 5023] 


Fyne API "fyne"' 


fyne 


import "fyne.io/fyne/v2" 


Package fyne describes the objects and components available to any Fyne app. These can all be created, 
manipulated and tested without rendering (for speed). Your main package should use the app package to 
create an application with a default driver that will render your UI. 


A simple application may look like this: 
package main 
import "fyne.io/fyne/v2/app" 


import "fyne.io/fyne/v2/container" 
import "fyne.io/fyne/v2/widget" 


func main() { 
a := app.New() 
w := a.NewWindow ("Hello") 
hello := widget.NewLabel ("Hello Fyne!") 
w.SetContent (container .NewVBox ( 
hello, 


widget .NewButton("Hi!", func() { 
hello.SetText ("Welcome :)") 


}), 
)) 


w.ShowAndRun () 


Usage 


const AnimationRepeatForever = -1l 
AnimationRepeatForever is an AnimationCount value that indicates it should not stop looping. 


Since: 2.0 
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const KeyModifierShortcutDefault = KeyModifierSuper 
KeyModifierShortcutDefault is the default key modifier for shortcuts (Control or Command). 


Since: 2.2 
const KeyModifierShortcutDefault = KeyModifierControl 


KeyModifierShortcutDefault is the default key modifier for shortcuts (Control or Command). 


Since: 2.2 


var ( 
// AnimationEaseInOut is the default easing, it starts slowly, accelerates to the middle and slows to the end. 


// 

// Since: 2.0 

AnimationEaseInOut = animationEaseInOut 

// AnimationEaseIn starts slowly and accelerates to the end. 
// 

// Since: 2.0 

AnimationEaseIn = animationEaseIn 

// AnimationEaseOut starts at speed and slows to the end. 

// 

// Since: 2.0 

AnimationEaseOut = animationEaseOut 

// AnimationLinear is a linear mapping for animations that progress uniformly through their duration. 
// 

// Since: 2.0 

AnimationLinear = animationLinear 


func IsHorizontal 


func IsHorizontal (orient DeviceOrientation) bool 


IsHorizontal is a helper utility that determines if a passed orientation is horizontal 


func IsVertical 


func IsVertical(orient DeviceOrientation) bool 


IsVertical is a helper utility that determines if a passed orientation is vertical 


func LogError 


func LogError(reason string, err error) 


LogError reports an error to the command line with the specified err cause, if not nil. The function also 
reports basic information about the code location. 


func Max 


func Max(x, y float32) float32 


Max returns the larger of the passed values. 
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func Min 


func Min(x, y float32) float32 


Min returns the smaller of the passed values. 


func SetCurrentApp 


func SetCurrentApp (current App) 


SetCurrentApp is an internal function to set the app instance currently running. 


types 
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Tags: 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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Fyne API "fyne"' 


fyne 


import "fyne.io/fyne/v2" 


Package fyne describes the objects and components available to any Fyne app. These can all be created, 
manipulated and tested without rendering (for speed). Your main package should use the app package to 
create an application with a default driver that will render your UI. 


A simple application may look like this: 
package main 
import "fyne.io/fyne/v2/app" 


import "fyne.io/fyne/v2/container" 
import "fyne.io/fyne/v2/widget" 


func main() { 
a := app.New() 
w := a.NewWindow ("Hello") 
hello := widget.NewLabel ("Hello Fyne!") 
w.SetContent (container .NewVBox ( 
hello, 


widget .NewButton("Hi!", func() { 
hello.SetText ("Welcome :)") 


}), 
)) 


w.ShowAndRun () 


Usage 


const AnimationRepeatForever = -1l 
AnimationRepeatForever is an AnimationCount value that indicates it should not stop looping. 


Since: 2.0 


i 


var ( 
// AnimationEaseInOut is the default easing, it starts slowly, accelerates to the middle and slows to the end. 


// 

// Since: 2.0 

AnimationEaseInOut = animationEaseInOut 

// AnimationEaseIn starts slowly and accelerates to the end. 
// 

// Since: 2.0 

AnimationEaseIn = animationEaseIn 

// AnimationEaseOut starts at speed and slows to the end. 

// 

// Since: 2.0 

AnimationEaseOut = animationEaseOut 

// AnimationLinear is a linear mapping for animations that progress uniformly through their duration. 
// 

// Since: 2.0 

AnimationLinear = animationLinear 


func IsHorizontal 


func IsHorizontal(orient DeviceOrientation) bool 


IsHorizontal is a helper utility that determines if a passed orientation is horizontal 


func IsVertical 


func IsVertical(orient DeviceOrientation) bool 


IsVertical is a helper utility that determines if a passed orientation is vertical 


func LogError 


func LogError(reason string, err error) 


LogError reports an error to the command line with the specified err cause, if not nil. The function also 
reports basic information about the code location. 


func Max 


func Max(x, y float32) float32 


Max returns the larger of the passed values. 


func Min 


func Min(x, y float32) float32 


Min returns the smaller of the passed values. 


func SetCurrentApp 


func SetCurrentApp (current App) 


SetCurrentApp is an internal function to set the app instance currently running. 


42 


types 


[Animation]tp 45] 
[AnimationCurvel[p 55] 
[App] [p 64] 
[BuildType][p 741 
[Canvas]ip 83] 
[CanvasObject|[p 93] 
[Clipboard] [p 103] 
[Container|[p 1121 
[Delta][p 123] 

[Device] ip 1321 
[DeviceOrientation){p 141] 
[Disableable]p 150] 
[DoubleTappable][p 159] 
[DragEvent|[p 168] 
[Draggable][p 177] 
[Driver] [p 186] 
[Focusablel{p 195] 
[HardwareKey]|p 204] 
[KeyEvent][p 213] 

[p 222] 
[ayoul]ip 234] 

[Legacy Theme] [p 243] 
[LifecyclelIp 253] 

[p 262] 
[MainMenu][p 271] 
[Menu] [p 280] 
[Menulter][p 289] 
[Notification)[p 299] 
[OverlayStack][p 308} 
[PointEvend][p 317] 
Position] {p 326] 
[Preferences] [p 336] 
[Resource] ip 346] 
[ScrofiEvend|[p 355] 
[Scroftable]{p 364] 
[Secondary Tappable[p 373] 
[Settings][p 3821 
[Shortcut] ip 391] 

[p 400] 
[ShortcutCu]|p 409] 

[p 418] 


[ShorteutPaste[p 427] 
ShortcutSelectAll|[p 436] 
[Shortcutable]ip 445} 

[p 454] 
[StaticResouree|[p 464) 
[Storagellp 474] 

[String Validatorl[p 483] 
[p 492] 

[p 501] 
[TextAlignl[p 510) 
[TextSiyle[p 519] 
TextWrap}|[p 528] 
[Themel{p 537] 
[ThemeColorNam@][p 546] 
[ThemefoonName][p 555] 
[ThemeSizeName][p 564] 
(p 573] 

[p 582] 
[ORIReadCloseip 592) 
[ORTWriteCloser|[p 601] 
[Validatable][p 610] 
[Vector |[p 619] 
[Widgell[p 628] 
[WidgetRenderey|[p 637] 
[Window]ip 646 


Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 


44 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


45 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


46 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


48 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


50 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


51 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


52 


© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API "fyne.Animation" 


fyne.Animation 


import "fyne.io/fyne/v2" 


Usage 


type Animation 


type Animation struct { 
AutoReverse bool 


Curve AnimationCurve 
Duration time.Duration 

RepeatCount int 

Tick func (float32) 


} 


Animation represents an animated element within a Fyne canvas. These animations may control individual 
objects or entire scenes. 


Since: 2.0 
func NewAnimation 
func NewAnimation(d time.Duration, fn func(float32)) *Animation 


NewAnimation creates a very basic animation where the callback function will be called for every 
rendered frame between time.Now() and the specified duration. The callback values start at 0.0 and will be 
1.0 when the animation completes. 


Since: 2.0 


func (*Animation) Start 


func (a *Animation) Start () 


Start registers the animation with the application run-loop and starts its execution. 
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func (*Animation) Stop 


func (a *Animation) Stop() 
Stop will end this animation and remove it from the run-loop. 
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Fyne API "fyne.AnimationCurve"' 


fyne.AnimationCurve 


import "fyne.io/fyne/v2" 


Usage 
type AnimationCurve 
type AnimationCurve func(float32) float32 


AnimationCurve represents an animation algorithm for calculating the progress through a timeline. 
Custom animations can be provided by implementing the afunc(float32) float324 definition. The input 
parameter will start at 0.0 when an animation starts and travel up to 1.0 at which point it will end. A linear 
animation would return the same output value as is passed in. 
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Fyne API "fyne.App" 
[Edit me] 


fyne.App 


import "fyne.io/fyne/v2" 


Usage 


type App 


type App interface { 
// Create a new window for the application. 
// The first window to open is considered the "master" and when closed 
// the application will exit. 
NewWindow(title string) Window 


// Open a URL in the default browser application. 
OpenURL (url *url.URL) error 


// Icon returns the application icon, this is used in various ways 
// depending on operating system. 

// This is also the default icon for new windows. 

Icon() Resource 


// SetIcon sets the icon resource used for this application instance. 
SetIcon (Resource) 


// Run the application - this starts the event loop and waits until Quit () 
// is called or the last window closes. 

// This should be called near the end of a main() function as it will block. 
Run () 


// Calling Quit on the application will cause the application to exit 

// cleanly, closing all open windows. 

// This function does no thing on a mobile device as the application lifecycle is 
// managed by the operating system. 

Quit () 


// Driver returns the driver that is rendering this application. 
// Typically not needed for day to day work, mostly internal functionality. 
Driver() Driver 


// UniqueID returns the application unique identifier, if set. 
// This must be set for use of the Preferences() functions... see NewWithId(string) 


UniqueID() string 


// SendNotification sends a system notification that will be displayed in the operating system’s notification area. 
SendNotification (*Notification) 


// Settings return the globally set settings, determining theme and so on. 
Settings() Settings 


// Preferences returns the application preferences, used for storing configuration and state 
Preferences() Preferences 


// Storage returns a storage handler specific to this application. 
Storage() Storage 
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// Lifecycle returns a type that allows apps to hook in to lifecycle events. 
Lifecycle() Lifecycle 


An App is the definition of a graphical application. Apps can have multiple windows, it will exit when the 
first window to be shown is closed. You can also cause the app to exit by calling Quit(). To start an 
application you need to call Run() somewhere in your main() function. Alternatively use the 
window.ShowAndRun() function for your main window. 


func CurrentApp 


func CurrentApp() App 


CurrentApp returns the current application, for which there is only 1 per process. 
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Fyne API "fyne.BuildType" 


fyne.BuildType 


import "fyne.io/fyne/v2" 


Usage 


type BuildType 


type BuildType int 


BuildType defines different modes that an application can be built using. 


const ( 


Tags: 


// BuildStandard is the normal build mode - it is not debug, test or release mode. 

BuildStandard BuildType = iota 

// BuildDebug is used when a developer would like more information and visual output for app debugging. 
BuildDebug 

// BuildRelease is a final production build, it is like BuildStandard but will use distribution certificates. 
// A release build is typically going to connect to live services and is not usually used during development. 
BuildRelease 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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Fyne API ''fyne.Canvas' 


fyne.Canvas 


import "fyne.io/fyne/v2" 


Usage 


type Canvas 


type Canvas interface { 
Content () CanvasObject 
SetContent (CanvasObject) 


Refresh (CanvasObject) 


// Focus makes the provided item focused. 

// The item has to be added to the contents of the canvas before calling this. 

Focus (Focusable) 

// FocusNext focuses the next focusable item. 

// If no item is currently focused, the first focusable item is focused. 

// If the last focusable item is currently focused, the first focusable item is focused. 
// 

// Since: 2.0 

FocusNext () 

// FocusPrevious focuses the previous focusable item. 

// If no item is currently focused, the last focusable item is focused. 

// If the first focusable item is currently focused, the last focusable item is focused. 


// 

// Since: 2.0 
FocusPrevious () 
Unfocus () 


Focused() Focusable 


// Size returns the current size of this canvas 

Size() Size 

// Scale returns the current scale (multiplication factor) this canvas uses to render 
// The pixel size of a CanvasObject can be found by multiplying by this value. 
Scale() float32 


// Overlays returns the overlay stack. 
Overlays() OverlayStack 


OnTypedRune() func (rune) 

SetOnTypedRune (func (rune) ) 

OnTypedKey() func (*KeyEvent) 

SetOnTypedKey (func (*KeyEvent) ) 

AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
RemoveShortcut (shortcut Shortcut) 


Capture() image.Image 
// PixelCoordinateForPosition returns the x and y pixel coordinate for a given position on this canvas. 


// This can be used to find absolute pixel positions or pixel offsets relative to an object top left. 
PixelCoordinateForPosition(Position) (int, int) 
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// InteractiveArea returns the position and size of the central interactive area. 
// Operating system elements may overlap the portions outside this area and widgets should avoid being outside. 


if 
// Since: 1.4 
InteractiveArea() (Position, Size) 


Canvas defines a graphical canvas to which a CanvasObject or Container can be added. Each canvas has a 
scale which is automatically applied during the render process. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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fyne.CanvasObject 


import "fyne.io/fyne/v2" 


Usage 


type CanvasObject 
type CanvasObject interface { 


// MinSize returns the minimum size this object needs to be drawn. 

MinSize() Size 

// Move moves this object to the given position relative to its parent. 

// This should only be called if your object is not in a container with a layout manager. 
Move (Position) 

// Position returns the current position of the object relative to its parent. 

Position() Position 

// Resize resizes this object to the given size. 

// This should only be called if your object is not in a container with a layout manager. 
Resize (Size) 

// Size returns the current size of this object. 

Size() Size 


// Hide hides this object. 

Hide () 

// Visible returns whether this object is visible or not. 
Visible() bool 

// Show shows this object. 

Show () 


// Refresh must be called if this object should be redrawn because its inner state changed. 
Refresh () 


CanvasObject describes any graphical object that can be added to a canvas. Objects have a size and 
position that can be controlled through this API. MinSize is used to determine the minimum size which 
this object should be displayed. An object will be visible by default but can be hidden with Hide() and 
re-shown with Show(). 


Note: If this object is controlled as part of a Layout you should not call Resize(Size) or Move(Position). 


101 


Tags: 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 


102 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


103 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


104 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


106 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


108 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


109 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


110 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "fyne.Clipboard"' 


fyne.Clipboard 


import "fyne.io/fyne/v2" 


Usage 
type Clipboard 


type Clipboard interface { 
// Content returns the clipboard content 
Content () string 
// SetContent sets the clipboard content 
SetContent (content string) 


} 
Clipboard represents the system clipboard interface 
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Fyne API "fyne.Container" 


fyne.Container 


import "fyne.io/fyne/v2" 


Usage 


type Container 


type Container struct { 
Hidden bool // Is this Container hidden 


Layout Layout // The Layout algorithm for arranging child CanvasObjects 
Objects []CanvasObject // The set of CanvasObjects this container holds 


} 


Container is a CanvasObject that contains a collection of child objects. The layout of the children is set by 
the specified Layout. 


func NewContainer 


func NewContainer(objects ...CanvasObject) *Container 
NewContainer returns a new Container instance holding the specified CanvasObjects. 


Deprecated: Use container. NewWithoutLayout() to create a container that uses manual layout. 


func NewContainerWithLayout 


func NewContainerWithLayout (layout Layout, objects ...CanvasObject) *Container 


NewContainerWithLayout returns a new Container instance holding the specified CanvasObjects which 
will be laid out according to the specified Layout. 


Deprecated: Use container.New() instead 
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func NewContainerWithoutLayout 


func NewContainerWithoutLayout (objects ...CanvasObject) *Container 


NewContainerWithoutLayout returns a new Container instance holding the specified CanvasObjects that 
are manually arranged. 


Deprecated: Use container. NewWithoutLayout() instead 


func (*Container) Add 


func (c *Container) Add(add CanvasObject) 
Add appends the specified object to the items this container manages. 


Since: 1.4 


func (*Container) AddObject 


func (c *Container) AddObject (o CanvasObject) 
AddObject adds another CanvasObject to the set this Container holds. 


Deprecated: Use replacement Add() function 


func (*Container) Hide 

func (c *Container) Hide () 

Hide sets this container, and all its children, to be not visible. 
func (*Container) MinSize 

func (c *Container) MinSize() Size 


MinSize calculates the minimum size of a Container. This is delegated to the Layout, if specified, 
otherwise it will mimic MaxLayout. 


func (*Container) Move 


func (c *Container) Move(pos Position) 


Move the container (and all its children) to a new position, relative to its parent. 


func (*Container) Position 


func (c *Container) Position() Position 


Position gets the current position of this Container, relative to its parent. 
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func (*Container) Refresh 


func (c *Container) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Container) Remove 


func (c *Container) Remove(rem CanvasObject) 


Remove updates the contents of this container to no longer include the specified object. 


func (*Container) Resize 


func (c *Container) Resize(size Size) 


Resize sets a new size for the Container. 


func (*Container) Show 


func (c *Container) Show() 


Show sets this container, and all its children, to be visible. 


func (*Container) Size 


func (c *Container) Size() Siz 


Size returns the current size of this container. 


func (*Container) Visible 


func (c *Container) Visible() bool 
Visible returns true if the container is currently visible, false otherwise. 
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Fyne API "fyne.Delta" 


fyne.Delta 


import "fyne.io/fyne/v2" 


Usage 


type Delta 


type Delta struct { 
DX, DY float32 
} 


Delta is a generic X, Y coordinate, size or movement representation. 


func NewDelta 


func NewDelta(dx float32, dy float32) Delta 


NewDelta returns a newly allocated Delta representing a movement in the X and Y axis. 


func (Delta) Components 


func (v Delta) Components() (float32, float32) 


Components returns the X and Y elements of this Delta. 


func (Delta) IsZero 


func (v Delta) IsZero() bool 
IsZero returns whether the Position is at the zero-point. 
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fyne.Device 


import "fyne.io/fyne/v2" 


Usage 


type Device 


type Device interface { 
Orientation() DeviceOrientation 
IsMobile() bool 
HasKeyboard() bool 
SystemScaleForWindow (Window) float32 
} 


Device provides information about the devices the code is running on 


func CurrentDevice 


func CurrentDevice() Devic 


CurrentDevice returns the device information for the current hardware (via the driver) 
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o (Listy Apalip 5023) 


Fyne API "fyne.DeviceOrientation"' 


fyne.DeviceOrientation 


import "fyne.io/fyne/v2" 


Usage 


type DeviceOrientation 


type DeviceOrientation int 


DeviceOrientation represents the different ways that a mobile device can be held 


const ( 


Tags: 


// OrientationVertical is the default vertical orientation 

OrientationVertical DeviceOrientation = iota 

// OrientationVerticalUpsideDown is the portrait orientation held upside down 
OrientationVerticalUpsideDown 

// OrientationHorizontalLeft is used to indicate a landscape orientation with the top to the left 
OrientationHorizontalLeft 

// OrientationHorizontalRight is used to indicate a landscape orientation with the top to the right 
OrientationHorizontalRight 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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Fyne API "fyne.Disableable"' 


fyne.Disableable 


import "fyne.io/fyne/v2" 


Usage 

type Disableable 

type Disableable interface { 
Enable () 
Disable () 
Disabled() bool 


} 


Disableable describes any CanvasObject that can be disabled. This is primarily used with objects that also 
implement the Tappable interface. 


Tags: 
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fyne.DoubleTappable 


import "fyne.io/fyne/v2" 


Usage 
type DoubleTappable 


type DoubleTappable interface { 
DoubleTapped (*PointEvent) 


} 
DoubleTappable describes any CanvasObject that can also be double tapped. 
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fyne.DragEvent 


import "fyne.io/fyne/v2" 


Usage 


type DragEvent 


type DragEvent struct { 
PointEvent 
Dragged Delta 


} 


DragEvent defines the parameters of a pointer or other drag event. The DraggedX and DraggedY fields 
show how far the item was dragged since the last event. 
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fyne.Draggable 


import "fyne.io/fyne/v2" 


Usage 
type Draggable 


type Draggable interface { 
Dragged (*DragEvent) 
DragEnd () 


} 


Draggable indicates that a CanvasObject can be dragged. This is used for any item that the user has 
indicated should be moved across the screen. 
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Fyne API "fyne.Driver" 


fyne.Driver 


import "fyne.io/fyne/v2" 


Usage 


type Driver 


type Driver interface { 
// CreateWindow creates a new UI Window. 
CreateWindow(string) Window 
// AllWindows returns a slice containing all app windows. 
AllWindows() []Window 


// RenderedTextSize returns the size required to render the given string of specified 
// font size and style. It also returns the height to text baseline, measured from the top. 
RenderedTextSize(text string, fontSize float32, style TextStyle) (size Size, baseline float32) 


// CanvasForObject returns the canvas that is associated with a given CanvasObject. 

CanvasForObject (CanvasObject) Canvas 

// AbsolutePositionForObject returns the position of a given CanvasObject relative to the top/left of a canvas. 
AbsolutePositionForObject (CanvasObject) Position 


// Device returns the device that the application is currently running on. 


Device() Device 
// Run starts the main event loop of the driver. 
Run () 


// Quit closes the driver and open windows, then exit the application. 
// On some some operating systems this does nothing, for example iOS and Android. 
Quit () 


// StartAnimation registers a new animation with this driver and requests it be started. 
StartAnimation (*Animation) 

// StopAnimation stops an animation and unregisters from this driver. 

StopAnimation (*Animation) 


Driver defines an abstract concept of a Fyne render driver. Any implementation must provide at least these 
methods. 
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Fyne API "fyne.Focusable"' 


fyne.Focusable 


import "fyne.io/fyne/v2" 


Usage 


type Focusable 


type Focusable interface { 
// FocusGained is a hook called by the focus handling logic after this object gained the focus. 
FocusGained () 
// FocusLost is a hook called by the focus handling logic after this object lost the focus. 
FocusLost () 


// TypedRune is a hook called by the input handling logic on text input events if this object is focused. 
TypedRune (rune) 


// TypedKey is a hook called by the input handling logic on key events if this object is focused. 
TypedKey (*KeyEvent) 


Focusable describes any CanvasObject that can respond to being focused. It will receive the FocusGained 
and FocusLost events appropriately. When focused it will also have TypedRune called as text is input and 
TypedKey called when other keys are pressed. 


Note: You must not change canvas state (including overlays or focus) in FocusGained or FocusLost or you 
would end up with a dead-lock. 
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Fyne API ''fyne.HardwareKey" 


fyne.HardwareKey 


import "fyne.io/fyne/v2" 


Usage 


type HardwareKey 


type HardwareKey struct { 
// ScanCode represents a hardware ID for (normally desktop) keyboard events. 
ScanCode int 


} 


HardwareKey contains information associated with physical key events Most applications should use 
KeyName for cross-platform compatibility. 
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Fyne API "fyne.KeyEvent"' 


fyne.KeyEvent 


import "fyne.io/fyne/v2" 


Usage 


type KeyEvent 


type KeyEvent struct { 
// Name describes the keyboard event that is consistent across platforms. 
Name KeyName 
// Physical is a platform specific field that reports the hardware information of physical keyboard events. 
Physical HardwareKey 
} 


KeyEvent describes a keyboard input event. 
Tags: 


If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 
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Fyne API "fyne.KeyName"' 


fyne.KeyName 


import "fyne.io/fyne/v2" 


Usage 


type KeyName 


type KeyName string 


KeyName represents the name of a key that has been pressed 


const ( 
// KeyEscape is the "esc" key 
KeyEscape KeyName = "Escape" 
// KeyReturn is the carriage return (main keyboard) 
KeyReturn KeyName = "Return" 
// KeyTab is the tab advance key 
KeyTab KeyName = "Tab" 
// KeyBackspace is the delete-before-cursor key 
KeyBackspace KeyName = "BackSpace" 
// KeyInsert is the insert mode key 
KeyInsert KeyName = "Insert" 
// KeyDelete is the delete-after-cursor key 
KeyDelete KeyName = "Delete" 
// KeyRight is the right arrow key 
KeyRight KeyName = "Right" 
// KeyLeft is the left arrow key 
KeyLeft KeyName = "Left" 
// KeyDown is the down arrow key 
KeyDown KeyName = "Down" 
// KeyUp is the up arrow key 
KeyUp KeyName = "Up" 
// KeyPageUp is the page up num-pad key 
KeyPageUp KeyName = "Prior" 
// KeyPageDown is the page down num-pad key 
KeyPageDown KeyName = "Next" 
// KeyHome is the line-home key 
KeyHome KeyName = "Home" 
// KeyEnd is the line-end key 
KeyEnd KeyName = "End" 
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// KeyFl is the first function key 
KeyFl KeyName = "F1" 

// KeyF2 is the second function key 
KeyF2 KeyName = "F2" 

// KeyF3 is the third function key 
KeyF3 KeyName = "F3" 

// KeyF4 is the fourth function key 
KeyF4 KeyName = "F4" 

// KeyF5 is the fifth function key 
KeyF5 KeyName = "F5" 

// KeyF6 is the sixth function key 
KeyF6 KeyName = "F6" 

// KeyF7 is the seventh function key 
KeyF7 KeyName = "F7" 

// KeyF8 is the eighth function key 
KeyF8 KeyName = "F8" 

// KeyF9 is the ninth function key 
KeyF9 KeyName = "F9" 

// KeyF10 is the tenth function key 
KeyF10 KeyName = "F10" 

// KeyF1l1 is the eleventh function key 
KeyF1ll KeyName = "F11" 

// KeyF12 is the twelfth function key 
KeyF12 KeyName = "F12" 


// KeyEnter is the enter/ return key (keypad) 
KeyEnter KeyName = "KP_Enter" 


// KeyO represents the key 0 
KeyO KeyName = "0" 
// Keyl represents the key 1 
Keyl KeyName = "1" 
// Key2 represents the key 2 
Key2 KeyName = "2" 
// Key3 represents the key 3 
Key3 KeyName = "3" 
// Key4 represents the key 4 
Key4 KeyName = "4" 
// Key5 represents the key 5 
Key5 KeyName = "5" 
// Key6 represents the key 6 
Key6 KeyName = "6" 
// Key7 represents the key 7 
Key7 KeyName = "7" 
// Key8 represents the key 8 
Key8 KeyName = "8" 
// Key9 represents the key 9 
Key9 KeyName = "9" 
// KeyA represents the key A 
KeyA KeyName = "A" 
// KeyB represents the key B 
KeyB KeyName = "B" 
// KeyC represents the key C 
KeyC KeyName = "C" 
// KeyD represents the key D 
KeyD KeyName = "D" 
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tH 


y 


(full stop) 


// KeyE represents the key 
KeyE KeyName = "EK" 

// KeyF represents the key 
KeyF KeyName = "F" 

// KeyG represents the key 
KeyG KeyName = "G" 

// KeyH represents the key 
KeyH KeyName = "H" 

// KeyI represents the key 
KeyI KeyName = "I" 

// Keyd represents the key 
KeyJ KeyName = "J" 

// KeyK represents the key 
KeyK KeyName = "K" 

// KeyL represents the key 
KeyL KeyName = "L" 

// KeyM represents the key 
KeyM KeyName = "M" 

// KeyN represents the key 
KeyN KeyName = "N" 

// KeyO represents the key 
KeyO KeyName = "0" 

// KeyP represents the key 
KeyP KeyName = "P" 

// KeyQ represents the key 
KeyQ KeyName = "Q" 

// KeyR represents the key 
KeyR KeyName = "R" 

// KeyS represents the key 
KeyS KeyName = "S" 

// KeyT represents the key 
KeyT KeyName = "T" 

// KeyU represents the key 
KeyU KeyName = "U" 

// KeyV represents the key 
KeyV KeyName = "Vv" 

// KeyW represents the key 
KeyW KeyName = "W" 

// KeyX represents the key 
KeyX KeyName = "X" 

// KeyY represents the key 
KeyY KeyName = "Y" 

// KeyZ represents the key 
KeyZ KeyName = "Z" 

// KeySpace is the space k 
KeySpace KeyName = "Space" 
// KeyApostrophe is the key "’" 
KeyApostrophe KeyName = "/" 
// KeyComma is the key "," 
KeyComma KeyName = "," 

// KeyMinus is the key "-" 
KeyMinus KeyName = "-" 

// KeyPeriod is the key "." 
KeyPeriod KeyName wet 

// KeySlash is the key "/" 
KeySlash KeyName = "/" 
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// KeyBackslash is the key "\" 

KeyBackslash KeyName = "\\" 

// KeyLeftBracket is the key "[" 
KeyLeftBracket KeyName = "[" 

// KeyRightBracket is the key "]" 
KeyRightBracket KeyName = "]" 

// KeySemicolon is the key ";" 

KeySemicolon KeyName = ";" 

// KeyEqual is the key "=" 

KeyEqual KeyName = "=" 

// KeyAsterisk is the keypad key "*" 
KeyAsterisk KeyName = "*" 

// KeyPlus is the keypad key "+" 

KeyPlus KeyName = "+" 

// KeyBackTick is the key "*‘" on a US keyboard 
KeyBackTick KeyName = "*‘" 

// KeyUnknown is used for key events where the underlying 


// event that Fyne could not decode. 


// 


// Since: 2.1 
KeyUnknown KeyName = "" 


) 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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Fyne API "'fyne.Layout"' 


fyne.Layout 


import "fyne.io/fyne/v2" 


Usage 


type Layout 


type Layout interface { 


} 


// Layout will manipulate the listed CanvasObjects Size and Position 
// to fit within the specified size. 

Layout ([]CanvasObject, Size) 

// MinSize calculates the smallest size that will fit the listed 

// CanvasObjects using this Layout algorithm. 

MinSize(objects []CanvasObject) Size 


Layout defines how CanvasObjects may be laid out in a specified Size. 
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Fyne API "fyne.LegacyTheme"' 


fyne.LegacyTheme 


import "fyne.io/fyne/v2" 


Usage 


type Legacy Theme 


type LegacyTheme interface { 
BackgroundColor() color.Color 
ButtonColor() color.Color 
DisabledButtonColor() color.Color 
TextColor() color.Color 
DisabledTextColor() color.Color 
PlaceHolderColor() color.Color 
PrimaryColor() color.Color 
HoverColor() color.Color 
FocusColor() color.Color 
ScrollBarColor() color.Color 
ShadowColor() color.Color 


TextSize() int 

TextFont() Resource 
TextBoldFont() Resource 
TextItalicFont() Resource 
TextBoldItalicFont() Resource 
TextMonospaceFont () Resource 


Padding() int 


IconInlineSize() int 
ScrollBarSize() int 
ScrollBarSmallSize() int 


LegacyTheme defines the requirements of any Fyne theme. This was previously called Theme and is kept 
for simpler transition of applications built before v2.0.0. 
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fyne.Lifecycle 


import "fyne.io/fyne/v2" 


Usage 


type Lifecycle 


type Lifecycle interface { 
// SetOnEnteredForeground hooks into the app becoming foreground and gaining focus. 
SetOnEnteredForeground (func () ) 
// SetOnExitedForeground hooks into the app losing input focus and going into the background. 
SetOnExitedForeground (func () ) 
// SetOnStarted hooks into an event that says the app is now running. 
SetOnStarted (func () ) 
// SetOnStopped hooks into an event that says the app is no longer running. 
SetOnStopped (func () ) 


Lifecycle represents the various phases that an app can transition through. 
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Fyne API "fyne.ListableURI" 


fyne.ListableURI 


import "fyne.io/fyne/v2" 


Usage 
type ListableURI 


type ListableURI interface { 
URI 


// List returns a list of child URIs of this URI. 
List() ([]URI, error) 
} 


ListableURI represents a URI that can have child items, most commonly a directory on disk in the native 
filesystem. 
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fyne.MainMenu 


import "fyne.io/fyne/v2" 


Usage 


type MainMenu 


type MainMenu struct { 
Items []*Menu 


} 


MainMenu defines the data required to show a menu bar (desktop) or other appropriate top level menu. 


func NewMainMenu 


func NewMainMenu(items ...*Menu) *MainMenu 


NewMainMenu creates a top level menu structure used by fyne. Window for displaying a menubar (or 
appropriate equivalent). 
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Fyne API "fyne.Menu" 


fyne.Menu 


import "fyne.io/fyne/v2" 


Usage 


type Menu 


type Menu struct { 
Label string 
Items []*MenuItem 


} 


Menu stores the information required for a standard menu. A menu can pop down from a MainMenu or 
could be a pop out menu. 


func NewMenu 


func NewMenu(label string, items ...*MenuItem) *Menu 


NewMent creates a new menu given the specified label (to show in a MainMenu) and list of items to 
display. 
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fyne.Menultem 


import "fyne.io/fyne/v2" 


Usage 


type Menultem 


type MenuItem struct { 
ChildMenu *Menu 
// Since: 2.1 


IsQuit bool 
IsSeparator bool 
Label string 
Action func () 


// Since: 2.1 

Disabled bool 

// Since: 2.1 

Checked bool 
} 


Menultem is a single item within any menu, it contains a display Label and Action function that is called 
when tapped. 


func NewMenultem 


func NewMenultem(label string, action func()) *MenuItem 


NewMenultem creates a new menu item from the passed label and action parameters. 


func NewMenultemSeparator 


func NewMenulItemSeparator() *MenuItem 
NewMenultemSeparator creates a menu item that is to be used as a separator. 
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fyne.Notification 


import "fyne.io/fyne/v2" 


Usage 


type Notification 


type Notification struct { 
Title, Content string 
} 


Notification represents a user notification that can be sent to the operating system. 


func NewNotification 


func NewNotification(title, content string) *Notification 
NewNotification creates a notification that can be passed to App.SendNotification. 
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fyne.OverlayStack 


import "fyne.io/fyne/v2" 


Usage 


type OverlayStack 


type OverlayStack interface { 
// Add adds an overlay on the top of the overlay stack. 
Add(overlay CanvasObject) 
// List returns the overlays currently on the overlay stack. 
List() []CanvasObject 
// Remove removes the given object and all objects above it from the overlay stack. 
Remove (overlay CanvasObject) 
// Top returns the top-most object of the overlay stack. 
Top() CanvasObject 
} 


OverlayStack is a stack of CanvasObjects intended to be used as overlays of a Canvas. 
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fyne.PointEvent 


import "fyne.io/fyne/v2" 


Usage 


type PointEvent 


type PointEvent struct { 
AbsolutePosition Position // The absolute position of the event 
Position Position // The relative position of the event 


} 


PointEvent describes a pointer input event. The position is relative to the top-left of the CanvasObject this 
is triggered on. 
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Fyne API "fyne.Position" 


fyne.Position 


import "fyne.io/fyne/v2" 


Usage 


type Position 


type Position struct { 
X float32 // The position from the parent’s left edg 
Y float32 // The position from the parent’s top edge 


} 


Position describes a generic X, Y coordinate relative to a parent Canvas or CanvasObject. 


func NewPos 


func NewPos(x float32, y float32) Position 


NewPos returns a newly allocated Position representing the specified coordinates. 


func (Position) Add 


func (p Position) Add(v Vector2) Position 


Add returns a new Position that is the result of offsetting the current position by p2 X and Y. 


func (Position) Components 


func (p Position) Components() (float32, float32) 


Components returns the X and Y elements of this Position 
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func (Position) IsZero 


func (p Position) IsZero() bool 


IsZero returns whether the Position is at the zero-point. 


func (Position) Subtract 


func (p Position) Subtract(v Vector2) Position 
Subtract returns a new Position that is the result of offsetting the current position by p2 -X and -Y. 
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Fyne API "fyne.Preferences"' 


fyne.Preferences 


import "fyne.io/fyne/v2" 


Usage 


type Preferences 


type Preferences interface { 
// Bool looks up a boolean value for the key 
Bool (key string) bool 


// BoolWithFallback looks up a boolean value and returns the given fallback if not found 


BoolWithFallback(key string, fallback bool) bool 
// SetBool saves a boolean value for the given key 
SetBool (key string, value bool) 


// Float looks up a float64 value for the key 

Float (key string) float64 

// FloatWithFallback looks up a float64 value and returns the given fallback 
FloatWithFallback(key string, fallback float64) floaté64 

// SetFloat saves a float64 value for the given key 

SetFloat (key string, value float64) 


// Int looks up an integer value for the key 
Int (key string) int 


if not found 


// IntWithFallback looks up an integer value and returns the given fallback if not found 


IntWithFallback(key string, fallback int) int 
// SetInt saves an integer value for the given key 
SetInt (key string, value int) 


// String looks up a string value for the key 

String(key string) string 

// StringWithFallback looks up a string value and returns the given fallback 
StringWithFallback (key, fallback string) string 

// SetString saves a string value for the given key 

SetString(key string, value string) 


// RemoveValue removes a value for the given key (not currently supported on 
RemoveValue (key string) 


// AddChangeListener allows code to be notified when some preferences change. 


AddChangeListener (func () ) 


Preferences describes the ways that an app can save and load user preferences 
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This will fire on any update. 
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Fyne API "fyne.Resource"' 


fyne.Resource 


import "fyne.io/fyne/v2" 


Usage 


type Resource 


type Resource interface { 
Name() string 
Content () []byte 


} 


Resource represents a single binary resource, such as an image or font. A resource has an identifying name 
and byte array content. The serialised path of a resource can be obtained which may result in a blocking 
filesystem write operation. 


func LoadResourceFromPath 


func LoadResourceFromPath(path string) (Resource, error) 


LoadResourceFromPath creates a new StaticResource in memory using the contents of the specified file. 


func LoadResourceFromURLString 


func LoadResourceFromURLString(urlStr string) (Resource, error) 


LoadResourceFromURLString creates a new StaticResource in memory using the body of the specified 
URL. 
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Fyne API "fyne.ScrollEvent"' 


fyne.ScrollEvent 


import "fyne.io/fyne/v2" 


Usage 


type ScrollEvent 


type ScrollEvent struct { 
PointEvent 
Scrolled Delta 


} 


ScrollEvent defines the parameters of a pointer or other scroll event. The DeltaX and DeltaY represent 
how large the scroll was in two dimensions. 
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fyne.Scrollable 


import "fyne.io/fyne/v2" 


Usage 
type Scrollable 


type Scrollable interface { 
Scrolled(*ScrollEvent) 


} 


Scrollable describes any CanvasObject that can also be scrolled. This is mostly used to implement the 
widget.ScrollContainer. 
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Fyne API "'fyne.SecondaryTappable"' 


fyne.SecondaryTappable 


import "fyne.io/fyne/v2" 


Usage 
type SecondaryTappable 


type SecondaryTappable interface { 
TappedSecondary (*PointEvent) 


} 
SecondaryTappable describes a CanvasObject that can be right-clicked or long-tapped. 
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Fyne API "'fyne.Settings"' 


fyne.Settings 


import "fyne.io/fyne/v2" 


Usage 


type Settings 


type Settings interface { 
Theme() Theme 
Set Theme (Theme) 
// ThemeVariant defines which preferred version of a theme should be used (i.e. light or dark) 
// 
// Since: 2.0 
ThemeVariant () ThemeVariant 
Scale() float32 
// PrimaryColor indicates a user preference for a named primary color 
// 
// Since: 1.4 
PrimaryColor() string 


AddChangeListener (chan Settings) 
BuildType() BuildType 


Settings describes the application configuration available. 
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Fyne API "fyne.Shortcut" 


fyne.Shortcut 


import "fyne.io/fyne/v2" 


Usage 


type Shortcut 


type Shortcut interface { 
ShortcutName() string 


} 
Shortcut is the interface used to describe a shortcut action 
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Fyne API "'fyne.ShortcutCopy"' 


fyne.ShortcutCopy 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutCopy 


type ShortcutCopy struct { 
Clipboard Clipboard 
} 


ShortcutCopy describes a shortcut copy action. 


func (*ShortcutCopy) ShortcutName 


func (se *ShortcutCopy) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.ShortcutCut" 


fyne.ShortcutCut 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutCut 


type ShortcutCut struct { 
Clipboard Clipboard 
} 


ShortcutCut describes a shortcut cut action. 


func (*ShortcutCut) ShortcutName 


func (se *ShortcutCut) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.ShortcutHandler"' 


fyne.ShortcutHandler 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutHandler 


type ShortcutHandler struct { 
} 


ShortcutHandler is a default implementation of the shortcut handler for the canvasObject 


func (*ShortcutHandler) AddShortcut 


func (sh *ShortcutHandler) AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
AddShortcut register an handler to be executed when the shortcut action is triggered 

func (*ShortcutHandler) RemoveShortcut 

func (sh *ShortcutHandler) RemoveShortcut (shortcut Shortcut) 

RemoveShortcut removes a registered shortcut 

func (*ShortcutHandler) TypedShortcut 

func (sh *ShortcutHandler) TypedShortcut (shortcut Shortcut) 

TypedShortcut handle the registered shortcut 
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Fyne API "fyne.ShortcutPaste"' 


fyne.ShortcutPaste 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutPaste 


type ShortcutPaste struct { 
Clipboard Clipboard 
} 


ShortcutPaste describes a shortcut paste action. 


func (*ShortcutPaste) ShortcutName 


func (se *ShortcutPaste) ShortcutName() string 
ShortcutName returns the shortcut name 
Tags: 
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Fyne API "'fyne.ShortcutSelectAll"' 


fyne.ShortcutSelectAll 


import "fyne.io/fyne/v2" 


Usage 
type ShortcutSelectAll 
type ShortcutSelectAll struct{} 


ShortcutSelectAll describes a shortcut selectAll action. 


func (*ShortcutSelectAll) ShortcutName 


func (se *ShortcutSelectAll) ShortcutName() string 
ShortcutName returns the shortcut name 
Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 


444 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


445 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


446 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


448 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


450 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


451 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


452 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "fyne.Shortcutable"' 


fyne.Shortcutable 


import "fyne.io/fyne/v2" 


Usage 


type Shortcutable 


type Shortcutable interface { 
TypedShortcut (Shortcut) 
} 


Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and 
paste). 
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Fyne API "fyne.Size" 


fyne.Size 


import "fyne.io/fyne/v2" 


Usage 


type Size 


type Size struct { 
Width float32 // The number of units along the X axis. 
Height float32 // The number of units along the Y axis. 


} 


Size describes something with width and height. 


func MeasureText 


func MeasureText (text string, size float32, style TextStyle) Siz 


MeasureText uses the current driver to calculate the size of text when rendered. 


func NewSize 


func NewSize(w float32, h float32) Size 


NewSize returns a newly allocated Size of the specified dimensions. 


func (Size) Add 


func (s Size) Add(v Vector2) Size 


Add returns a new Size that is the result of increasing the current size by s2 Width and Height. 
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func (Size) Components 


func (s Size) Components() (float32, float32) 


Components returns the Width and Height elements of this Size 


func (Size) IsZero 


func (s Size) IsZero() bool 


IsZero returns whether the Size has zero width and zero height. 


func (Size) Max 


func (s Size) Max(v Vector2) Size 

Max returns a new Size that is the maximum of the current Size and s2. 
func (Size) Min 

func (s Size) Min(v Vector2) Size 


Min returns a new Size that is the minimum of the current Size and s2. 


func (Size) Subtract 


func (s Size) Subtract(v Vector2) Size 
Subtract returns a new Size that is the result of decreasing the current size by s2 Width and Height. 
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Fyne API "fyne.StaticResource"' 


fyne.StaticResource 


import "fyne.io/fyne/v2" 


Usage 


type StaticResource 


type StaticResource struct { 
StaticName string 
StaticContent []byte 
} 


StaticResource is a bundled resource compiled into the application. These resources are normally 
generated by the fyne_bundle command included in the Fyne toolkit. 


func NewStaticResource 
func NewStaticResource(name string, content []byte) *StaticResource 


NewStaticResource returns a new static resource object with the specified name and content. Creating a 
new Static resource in memory results in sharable binary data that may be serialised to the location 
returned by CachePath(). 

func (*StaticResource) Content 


func (r *StaticResource) Content() []byte 


Content returns the bytes of the bundled resource, no compression is applied but any compression on the 
resource is retained. 


func (*StaticResource) GoString 


func (r *StaticResource) GoString() string 


GoString converts a Resource object to Go code. This is useful if serialising to a Go file for compilation 
into a binary. 
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func (*StaticResource) Name 


func (r *StaticResource) Name() string 
Name returns the unique name of this resource, usually matching the file it was generated from. 
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fyne.Storage 


import "fyne.io/fyne/v2" 


Usage 


type Storage 


type Storage interface { 
RootURI() URI 


Create (name string) (URIWriteCloser, error) 
Open(name string) (URIReadCloser, error) 
Save(name string) (URIWriteCloser, error) 


Remove (name string) error 


List() []string 
} 


Storage is used to manage file storage inside an application sandbox. The files managed by this interface 
are unique to the current application. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


482 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


483 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


484 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


486 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


488 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


489 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


490 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
e [List My Appl[p 5023] 
Fyne API "fyne.StringValidator" 


fyne.String Validator 


import "fyne.io/fyne/v2" 


Usage 

type StringValidator 

type StringValidator func(string) error 

String Validator is a function signature for validating string inputs. 
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fyne.Tabbable 


import "fyne.io/fyne/v2" 


Usage 
type Tabbable 


type Tabbable interface { 
// AcceptsTab() is a hook called by the key press handling logic. 
// Tf it returns true then the Tab key events will be sent using TypedKey. 
AcceptsTab() bool 


} 
Tabbable describes any object that needs to accept the Tab key presses. 
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fyne.Tappable 


import "fyne.io/fyne/v2" 


Usage 
type Tappable 


type Tappable interface { 
Tapped (*PointEvent) 


} 


Tappable describes any CanvasObject that can also be tapped. This should be implemented by buttons etc 
that wish to handle pointer interactions. 
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Fyne API "fyne.TextAlign" 


fyne.TextAlign 


import "fyne.io/fyne/v2" 


Usage 
type TextAlign 


type TextAlign int 


TextAlign represents the horizontal alignment of text within a widget or canvas object. 


const ( 
// TextAlignLeading specifies a left alignment for left-to-right languages. 
TextAlignLeading TextAlign = iota 
// TextAlignCenter places the text centrally within the available space. 
TextAlignCenter 
// TextAlignTrailing will align the text right for a left-to-right language. 
TextAlignTrailing 

) 
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Fyne API "fyne.TextStyle" 


fyne.TextStyle 


import "fyne.io/fyne/v2" 


Usage 


type TextStyle 

type TextStyle struct { 
Bold bool // Should text be bold 
Italic bool // Should text be italic 


Monospace bool // Use the system monospace font instead of regular 


// Since: 2.1 
TabWidth int // Width of tabs in spaces 
} 
TextStyle represents the styles that can be applied to a text canvas object or text based widget. 
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fyne.TextWrap 


import "fyne.io/fyne/v2" 


Usage 
type TextWrap 


type TextWrap int 


TextWrap represents how text longer than the widgetas width will be wrapped. 


const ( 
// TextWrapOff extends the widget’s width to fit the text, no wrapping is applied. 
TextWrapOff TextWrap = iota 
// TextTruncate trims the text to the widget’s width, no wrapping is applied. 
// Tf an entry is asked to truncate it will provide scrolling capabilities. 
TextTruncate 
// TextWrapBreak trims the line of characters to the widget’s width adding the excess as new line. 
// An Entry with text wrapping will scroll vertically if there is not enough space for all the text. 
TextWrapBreak 
// TextWrapWord trims the line of words to the widget’s width adding the excess as new line. 
// An Entry with text wrapping will scroll vertically if there is not enough space for all the text. 
TextWrapWord 
) 
Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


536 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


537 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


538 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


540 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


542 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


543 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


544 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodelD][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "fyne.Theme"' 


fyne. Theme 


import "fyne.io/fyne/v2" 


Usage 


type Theme 


type Theme interface { 
Color (ThemeColorName, ThemeVariant) color.Color 
Font (TextStyle) Resourc 
Icon(ThemeIconName) Resource 
Size(ThemeSizeName) float32 


} 
Theme defines the method to look up colors, sizes and fonts that make up a Fyne theme. 
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fyne. ThemeColorName 


import "fyne.io/fyne/v2" 


Usage 

type ThemeColorName 

type ThemeColorName string 

ThemeColorName is used to look up a colour based on its name. 


Since: 2.0 
Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


554 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


555 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


556 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


558 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


560 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


561 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


562 


© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023} 


Fyne API "fyne.ThemeIconName"' 


fyne. ThemeIconName 


import "fyne.io/fyne/v2" 


Usage 

type ThemeIconName 

type ThemeIconName string 

ThemelIconName is used to look up an icon based on its name. 
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Fyne API "fyne.ThemeSizeName"' 


fyne. ThemeSizeName 


import "fyne.io/fyne/v2" 


Usage 


type ThemeSizeName 


type ThemeSizeName string 


ThemeSizeName is used to look up a size based on its name. 
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fyne. Theme Variant 


import "fyne.io/fyne/v2" 


Usage 

type ThemeVariant 

type ThemeVariant uint 

ThemeVariant indicates a variation of a theme, such as light or dark. 
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© [List My Applip 5023] 


Fyne API "fyne.URI" 


fyne.URI 


import "fyne.io/fyne/v2" 


Usage 
type URI 


type URI interface { 
fmt .Stringer 


// Extension should return the file extension of the resource 

// referenced by the URI. For example, the Extension() of 

// 'file://foo/bar.baz’ is 'baz’. May return an empty string if the 
// cveferenced resource has none. 

Extension() string 


// Name should return the base name of the item referenced by the URI. 
// For example, the Name() of '’file://foo/bar.baz’ is 'bar.baz’. 
Name() string 


// MimeType should return the content type of the resource referenced 
// by the URI. The returned string should be in the format described 
// by Section 5 of RFC2045 ("Content-Type Header Field"). 

MimeType() string 


// Scheme should return the URI scheme of the URI as defined by IETF 
// RFC3986. For example, the Scheme() of 'file://foo/bar.baz* is 


// ‘file’. 

// 

// Scheme should always return the scheme in all lower-case characters. 
Scheme() string 


// Authority should return the URI authority, as defined by IETF 

// RFC3986. 

// 

// NOTE: the RFC3986 can be obtained by combining the User and Host 
// Fields of net/url’s URL structure. Consult IETF RFC3986, section 
f/--3.2, ppe 1Ts 

// 

// Since: 2.0 
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Authority() string 


// Path should return the URI path, 


// 
// Since: 2.0 
Path() string 


// Query should return the URI query, 


// 
// Since: 2.0 
Query() string 


// Fragment should return the URI fragment, 


// RFC3986. 

“ah 

// Since: 2.0 
Fragment () string 


} 


as defined by I! 


as defined by II 


as defined by II 


ETF RFC3986. 


ETF RFC3986. 


ETE 


URI represents the identifier of a resource on a target system. This resource may be a file or another data 


source such as an app or file sharing system. 


In general, it is expected that URI implementations follow IETF RFC3896. Implementations are highly 
recommended to utilize net/url to implement URI parsing methods, especially Scheme(), AUthorityQ, 


Path(), Query(), and Fragment(). 
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fyne. URIReadCloser 


import "fyne.io/fyne/v2" 


Usage 
type URIReadCloser 


type URIReadCloser interface { 
io.ReadCloser 


URI() URI 
} 


URIReadCloser represents a cross platform data stream from a file or provider of data. It may refer to an 
item on a filesystem or data in another application that we have access to. 
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fyne.URIWriteCloser 


import "fyne.io/fyne/v2" 


Usage 
type URIWriteCloser 


type URIWriteCloser interface { 
io.WriteCloser 


URI() URI 
} 


URIWriteCloser represents a cross platform data writer for a file resource. This will normally refer to a 
local file resource. 
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Fyne API "fyne.Validatable"' 


fyne. Validatable 


import "fyne.io/fyne/v2" 


Usage 
type Validatable 


type Validatable interface { 
Validate() error 


// SetOnValidationChanged is used to set the callback that will be triggered when the validation state changes. 
// The function might be overwritten by a parent that cares about child validation (e.g. widget.Form). 
SetOnValidationChanged (func (error) ) 

} 


Validatable is an interface for specifying if a widget is validatable. 
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Fyne API "fyne.Vector2"' 


fyne.Vector2 


import "fyne.io/fyne/v2" 


Usage 


type Vector2 


type Vector2 interface { 
Components() (float32, float32) 
IsZero() bool 
} 
Vector2 marks geometry types that can operate as a coordinate vector. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 


627 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


628 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


629 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


631 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


633 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


634 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


635 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
e [TreeNodeID][p 5014] 
@ [List My App][p 5023] 
Fyne API "'fyne. Widget" 


fyne. Widget 


import "fyne.io/fyne/v2" 


Usage 
type Widget 


type Widget interface { 
CanvasObject 


// CreateRenderer returns a new WidgetRenderer for this widget. 
// This should not be called by regular code, it is used internally to render a widget. 


CreateRenderer() WidgetRenderer 


} 


Widget defines the standard behaviours of any widget. This extends the CanvasObject - a widget behaves 
in the same basic way but will encapsulate many child objects to create the rendered widget. 
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fyne.WidgetRenderer 


import "fyne.io/fyne/v2" 


Usage 


type WidgetRenderer 


type WidgetRenderer interface { 


// Destroy is for internal use. 

Destroy () 

// Layout is a hook that is called if the widget needs to be laid out. 

// This should never call Refresh. 

Layout (Size) 

// MinSize returns the minimum size of the widget that is rendered by this renderer. 
MinSize() Size 

// Objects returns all objects that should be drawn. 

Objects() []CanvasObject 

// Refresh is a hook that is called if the widget has updated and needs to be redrawn. 
// This might trigger a Layout. 

Refresh () 


WidgetRenderer defines the behaviour of a widgetas implementation. This is returned from a widgetas 
declarative object through the CreateRenderer() function and should be exactly one instance per widget in 


memory. 
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Fyne API "fyne.Window"' 


fyne.Window 


import "fyne.io/fyne/v2" 


Usage 
type Window 


type Window interface { 
// Title returns the current window title. 
// This is typically displayed in the window decorations. 
Title() string 
// SetTitle updates the current title of the window. 
SetTitle (string) 


// FullScreen returns whether or not this window is currently full screen. 
FullScreen() bool 

// SetFullScreen changes the requested fullScreen property 

// true for a fullScreen window and false to unset this. 

SetFullScreen (bool) 


// Resize this window to the requested content siz 

// The result may not be exactly as desired due to various desktop or 
// platform constraints. 

Resize (Size) 


// RequestFocus attempts to raise and focus this window. 

// This should only be called when you are sure the user would want this window 
// to steal focus from any current focused window. 

RequestFocus () 


// FixedSize returns whether or not this window should disable resizing. 
FixedSize() bool 

// SetFixedSize sets a hint that states whether the window should be a fixed 
// size or allow resizing. 

SetFixedSize (bool) 


// CenterOnScreen places a window at the center of the monitor 
// the Window object is currently positioned on. 
CenterOnScreen () 


654 


// Padded, normally true, states whether the window should have inner 

// padding so that components do not touch the window edge. 

Padded() bool 

// SetPadded allows applications to specify that a window should have 

// no inner padding. Useful for fullscreen or graphic based applications. 
SetPadded (bool) 


// Tcon returns the window icon, this is used in various ways 

// depending on operating system. 

// Most commonly this is displayed on the window border or task switcher. 
Icon() Resource 


// SetIcon sets the icon resource used for this window. 
// Tf none is set should return the application icon. 
SetIcon (Resource) 


// SetMaster indicates that closing this window should exit the app 
SetMaster () 


// MainMenu gets the content of the window’s top level menu. 
MainMenu() *MainMenu 


// SetMainMenu adds a top level menu to this window. 
// The way this is rendered will depend on the loaded driver. 
SetMainMenu (*MainMenu) 


// SetOnClosed sets a function that runs when the window is closed. 
SetOnClosed (func () ) 


// SetCloseIntercept sets a function that runs instead of closing if defined. 
// Close() should be called explicitly in the interceptor to close the window. 
// 

// Since: 1.4 

SetCloseIntercept (func () ) 


// Show the window on screen. 

Show () 

// Hide the window from the user. 

// This will not destroy the window or cause the app to exit. 

Hide () 

// Close the window. 

// If it is the only open window, or the "master" window the app will Quit. 
Close () 


// ShowAndRun is a shortcut to show the window and then run the application. 
// This should be called near th nd of a main() function as it will block. 
ShowAndRun () 


// Content returns the content of this window. 

Content () CanvasObject 

// SetContent sets the content of this window. 

SetContent (CanvasObject) 

// Canvas returns the canvas context to render in the window. 

// This can be useful to set a key handler for the window, for example. 
Canvas() Canvas 
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// Clipboard returns the system clipboard 
Clipboard() Clipboard 


Window describes a user interface window. Depending on the platform an app may have many windows 


or just the one. 
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Fyne API "fyne"' 


fyne 


import "fyne.io/fyne/v2" 


Package fyne describes the objects and components available to any Fyne app. These can all be created, 
manipulated and tested without rendering (for speed). Your main package should use the app package to 
create an application with a default driver that will render your UI. 


A simple application may look like this: 
package main 
import "fyne.io/fyne/v2/app" 


import "fyne.io/fyne/v2/container" 
import "fyne.io/fyne/v2/widget" 


func main() { 
a := app.New() 
w := a.NewWindow ("Hello") 
hello := widget.NewLabel ("Hello Fyne!") 
w.SetContent (container .NewVBox ( 
hello, 


widget .NewButton("Hi!", func() { 
hello.SetText ("Welcome :)") 


}), 
)) 


w.ShowAndRun () 


Usage 


const AnimationRepeatForever = -1l 
AnimationRepeatForever is an AnimationCount value that indicates it should not stop looping. 


Since: 2.0 
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var ( 
// AnimationEaseInOut is the default easing, it starts slowly, accelerates to the middle and slows to the end. 


// 

// Since: 2.0 

AnimationEaseInOut = animationEaseInOut 

// AnimationEaseIn starts slowly and accelerates to the end. 
// 

// Since: 2.0 

AnimationEaseIn = animationEaseIn 

// AnimationEaseOut starts at speed and slows to the end. 

// 

// Since: 2.0 

AnimationEaseOut = animationEaseOut 

// AnimationLinear is a linear mapping for animations that progress uniformly through their duration. 
// 

// Since: 2.0 

AnimationLinear = animationLinear 


func IsHorizontal 


func IsHorizontal(orient DeviceOrientation) bool 


IsHorizontal is a helper utility that determines if a passed orientation is horizontal 


func IsVertical 


func IsVertical(orient DeviceOrientation) bool 


IsVertical is a helper utility that determines if a passed orientation is vertical 


func LogError 


func LogError(reason string, err error) 


LogError reports an error to the command line with the specified err cause, if not nil. The function also 
reports basic information about the code location. 


func Max 


func Max(x, y float32) float32 


Max returns the larger of the passed values. 


func Min 


func Min(x, y float32) float32 


Min returns the smaller of the passed values. 


func SetCurrentApp 


func SetCurrentApp (current App) 


SetCurrentApp is an internal function to set the app instance currently running. 


666 


types 


[Animation] [p 669] 
[AnimationCurve][p 679] 
[Appl lp 688] 
[BuildType][p 698] 
[Canvas][p 707] 
[CanvasObject][p 717] 
[Clipboard] [p 727] 
[Container [p 736] 
[Delta] [p 747] 

[Device][p 756] 
[DeviceOrientation][p 765] 
[Disableable][p 774] 
[DoubleTappable][p 783] 
[DragEvent|[p 792] 
[Draggable][p 801] 
[Driver] [p 810] 
[Focusable][p 819] 
[KeyEvent|[p 828] 
[KeyName][p 837] 

[p 849] 
[LegacyTheme][p 858] 
[ListableURI][p 868] 
[MainMenu] [p 877] 
[Menu] [p 886] 
[Menultem][p 895] 
[Notification][p 904] 
[OverlayStack][p 913] 
[PointEvent][p 922] 
[Position] [p 931] 
[Preferences][p 941] 
[Resource] [p 951] 
[ScrollEvent][p 960] 
[Scrollable]{p 969] 
[SecondaryTappable][p 978] 
[Settings][p 987] 
[Shortcui][p 996] 

[p 1005] 
[ShortcutCut][p 1014] 

[p 1023] 
[ShortcutPaste][p 1032] 
[p 1041] 


667 


[Shortcutable] p 1050] 
[Size][p 1059] 
[StaticResource|[p 1069] 
[Storage][p 1079] 

[String Validator|[p 1088] 
[Fappable][p 1097] 
[FextAlign][p 1106] 
[FextStyle]ip 1115] 
TextWrap|[p 1124] 
[Theme][p 1133] 
[ThemeColorName][p 1142] 
[ThemelconName]{p 1151] 
[ThemeSizeName]|p 1160) 
[p 1169] 
[URI|[p 1178] 

[p 1188] 
[URTWriteCloser|{p 1197] 
[Validatable][p 1206] 
[Vector2][p 1215] 
[Widget|[p 1224] 
[WidgetRenderey|ip 1233] 
[Window][p 1242] 


Tags: 


If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 


668 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


669 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p ??] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


670 


© Layout and widget size 
© Customisation 


© (API Documentation][p ”7 

© [Upgrade 10 v2.2][p 2665] 

0 [Fyne API v2.2]Ip 211 
package fyne][p 211 
[Animation][p 2675] 
[AnimationCurve][p 2685] 
[App][p 2694] 
[AppMetadatal[p 2704] 
[BuildTypel[p 2713] 
[Canvas][p 2722] 
[CanvasObjeci|[p 27321 
[Clipboard] {p 27421 
[Container|[p 2751] 
[p 2762] 
[Device][p 2771] 
[p 2780] 
[Disableable]|p 2789| 
[DoubleTappable|[p 2798] 
[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey]Ip 2843] 
[KeyboardShortcut][p 2852] 
[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme][p 2900] 
[Lifecyclel[p 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification)[p 2956} 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[SeroflabIe][p 3012} 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


672 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


674 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


675 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


676 


© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API "fyne.Animation" 


fyne.Animation 


import "fyne.io/fyne/v2" 


Usage 


type Animation 


type Animation struct { 
AutoReverse bool 


Curve AnimationCurve 
Duration time.Duration 

RepeatCount int 

Tick func (float32) 


} 


Animation represents an animated element within a Fyne canvas. These animations may control individual 
objects or entire scenes. 


Since: 2.0 
func NewAnimation 
func NewAnimation(d time.Duration, fn func(float32)) *Animation 


NewAnimation creates a very basic animation where the callback function will be called for every 
rendered frame between time.Now() and the specified duration. The callback values start at 0.0 and will be 
1.0 when the animation completes. 


Since: 2.0 


func (*Animation) Start 


func (a *Animation) Start () 


Start registers the animation with the application run-loop and starts its execution. 
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func (*Animation) Stop 


func (a *Animation) Stop() 
Stop will end this animation and remove it from the run-loop. 
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Fyne API "fyne.AnimationCurve"' 


fyne.AnimationCurve 


import "fyne.io/fyne/v2" 


Usage 
type AnimationCurve 
type AnimationCurve func(float32) float32 


AnimationCurve represents an animation algorithm for calculating the progress through a timeline. 
Custom animations can be provided by implementing the afunc(float32) float324 definition. The input 
parameter will start at 0.0 when an animation starts and travel up to 1.0 at which point it will end. A linear 
animation would return the same output value as is passed in. 
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Fyne API "fyne.App" 
[Edit me] 


fyne.App 


import "fyne.io/fyne/v2" 


Usage 


type App 


type App interface { 
// Create a new window for the application. 
// The first window to open is considered the "master" and when closed 
// the application will exit. 
NewWindow(title string) Window 


// Open a URL in the default browser application. 
OpenURL (url *url.URL) error 


// Icon returns the application icon, this is used in various ways 
// depending on operating system. 

// This is also the default icon for new windows. 

Icon() Resource 


// SetIcon sets the icon resource used for this application instance. 
SetIcon (Resource) 


// Run the application - this starts the event loop and waits until Quit () 
// is called or the last window closes. 

// This should be called near the end of a main() function as it will block. 
Run () 


// Calling Quit on the application will cause the application to exit 

// cleanly, closing all open windows. 

// This function does no thing on a mobile device as the application lifecycle is 
// managed by the operating system. 

Quit () 


// Driver returns the driver that is rendering this application. 
// Typically not needed for day to day work, mostly internal functionality. 
Driver() Driver 


// UniqueID returns the application unique identifier, if set. 
// This must be set for use of the Preferences() functions... see NewWithId(string) 


UniqueID() string 


// SendNotification sends a system notification that will be displayed in the operating system’s notification area. 
SendNotification (*Notification) 


// Settings return the globally set settings, determining theme and so on. 
Settings() Settings 


// Preferences returns the application preferences, used for storing configuration and state 
Preferences() Preferences 
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// Storage returns a storage handler specific to this application. 
Storage() Storage 


An App is the definition of a graphical application. Apps can have multiple windows, it will exit when the 
first window to be shown is closed. You can also cause the app to exit by calling Quit(). To start an 
application you need to call Run() somewhere in your main() function. Alternatively use the 
window.ShowAndRun() function for your main window. 


func CurrentApp 


func CurrentApp() App 


CurrentApp returns the current application, for which there is only 1 per process. 
Tags: 
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Fyne API "fyne.BuildType" 


fyne.BuildType 


import "fyne.io/fyne/v2" 


Usage 


type BuildType 


type BuildType int 


BuildType defines different modes that an application can be built using. 


const ( 


Tags: 


// BuildStandard is the normal build mode - it is not debug, test or release mode. 

BuildStandard BuildType = iota 

// BuildDebug is used when a developer would like more information and visual output for app debugging. 
BuildDebug 

// BuildRelease is a final production build, it is like BuildStandard but will use distribution certificates. 
// A release build is typically going to connect to live services and is not usually used during development. 
BuildRelease 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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Fyne API ''fyne.Canvas' 


fyne.Canvas 


import "fyne.io/fyne/v2" 


Usage 


type Canvas 


type Canvas interface { 
Content () CanvasObject 
SetContent (CanvasObject) 


Refresh (CanvasObject) 


// Focus makes the provided item focused. 

// The item has to be added to the contents of the canvas before calling this. 

Focus (Focusable) 

// FocusNext focuses the next focusable item. 

// If no item is currently focused, the first focusable item is focused. 

// If the last focusable item is currently focused, the first focusable item is focused. 
// 

// Since: 2.0 

FocusNext () 

// FocusPrevious focuses the previous focusable item. 

// If no item is currently focused, the last focusable item is focused. 

// If the first focusable item is currently focused, the last focusable item is focused. 


// 

// Since: 2.0 
FocusPrevious () 
Unfocus () 


Focused() Focusable 


// Size returns the current size of this canvas 

Size() Size 

// Scale returns the current scale (multiplication factor) this canvas uses to render 
// The pixel size of a CanvasObject can be found by multiplying by this value. 
Scale() float32 


// Overlays returns the overlay stack. 
Overlays() OverlayStack 


OnTypedRune() func (rune) 

SetOnTypedRune (func (rune) ) 

OnTypedKey() func (*KeyEvent) 

SetOnTypedKey (func (*KeyEvent) ) 

AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
RemoveShortcut (shortcut Shortcut) 


Capture() image.Image 
// PixelCoordinateForPosition returns the x and y pixel coordinate for a given position on this canvas. 


// This can be used to find absolute pixel positions or pixel offsets relative to an object top left. 
PixelCoordinateForPosition(Position) (int, int) 
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// InteractiveArea returns the position and size of the central interactive area. 
// Operating system elements may overlap the portions outside this area and widgets should avoid being outside. 


if 
// Since: 1.4 
InteractiveArea() (Position, Size) 


Canvas defines a graphical canvas to which a CanvasObject or Container can be added. Each canvas has a 
scale which is automatically applied during the render process. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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Fyne API "'fyne.CanvasObject"' 


fyne.CanvasObject 


import "fyne.io/fyne/v2" 


Usage 


type CanvasObject 
type CanvasObject interface { 


// MinSize returns the minimum size this object needs to be drawn. 

MinSize() Size 

// Move moves this object to the given position relative to its parent. 

// This should only be called if your object is not in a container with a layout manager. 
Move (Position) 

// Position returns the current position of the object relative to its parent. 

Position() Position 

// Resize resizes this object to the given size. 

// This should only be called if your object is not in a container with a layout manager. 
Resize (Size) 

// Size returns the current size of this object. 

Size() Size 


// Hide hides this object. 

Hide () 

// Visible returns whether this object is visible or not. 
Visible() bool 

// Show shows this object. 

Show () 


// Refresh must be called if this object should be redrawn because its inner state changed. 
Refresh () 


CanvasObject describes any graphical object that can be added to a canvas. Objects have a size and 
position that can be controlled through this API. MinSize is used to determine the minimum size which 
this object should be displayed. An object will be visible by default but can be hidden with Hide() and 
re-shown with Show(). 


Note: If this object is controlled as part of a Layout you should not call Resize(Size) or Move(Position). 
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fyne.Clipboard 


import "fyne.io/fyne/v2" 


Usage 
type Clipboard 


type Clipboard interface { 
// Content returns the clipboard content 
Content () string 
// SetContent sets the clipboard content 
SetContent (content string) 


} 
Clipboard represents the system clipboard interface 
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Fyne API "fyne.Container" 


fyne.Container 


import "fyne.io/fyne/v2" 


Usage 


type Container 


type Container struct { 
Hidden bool // Is this Container hidden 


Layout Layout // The Layout algorithm for arranging child CanvasObjects 
Objects []CanvasObject // The set of CanvasObjects this container holds 


} 


Container is a CanvasObject that contains a collection of child objects. The layout of the children is set by 
the specified Layout. 


func NewContainer 


func NewContainer(objects ...CanvasObject) *Container 
NewContainer returns a new Container instance holding the specified CanvasObjects. 


Deprecated: Use container. NewWithoutLayout() to create a container that uses manual layout. 


func NewContainerWithLayout 


func NewContainerWithLayout (layout Layout, objects ...CanvasObject) *Container 


NewContainerWithLayout returns a new Container instance holding the specified CanvasObjects which 
will be laid out according to the specified Layout. 


Deprecated: Use container.New() instead 
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func NewContainerWithoutLayout 


func NewContainerWithoutLayout (objects ...CanvasObject) *Container 


NewContainerWithoutLayout returns a new Container instance holding the specified CanvasObjects that 
are manually arranged. 


Deprecated: Use container. NewWithoutLayout() instead 


func (*Container) Add 


func (c *Container) Add(add CanvasObject) 
Add appends the specified object to the items this container manages. 


Since: 1.4 


func (*Container) AddObject 


func (c *Container) AddObject (o CanvasObject) 
AddObject adds another CanvasObject to the set this Container holds. 


Deprecated: Use replacement Add() function 


func (*Container) Hide 

func (c *Container) Hide () 

Hide sets this container, and all its children, to be not visible. 
func (*Container) MinSize 

func (c *Container) MinSize() Size 


MinSize calculates the minimum size of a Container. This is delegated to the Layout, if specified, 
otherwise it will mimic MaxLayout. 


func (*Container) Move 


func (c *Container) Move(pos Position) 


Move the container (and all its children) to a new position, relative to its parent. 


func (*Container) Position 


func (c *Container) Position() Position 


Position gets the current position of this Container, relative to its parent. 


745 


func (*Container) Refresh 


func (c *Container) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Container) Remove 


func (c *Container) Remove(rem CanvasObject) 


Remove updates the contents of this container to no longer include the specified object. 


func (*Container) Resize 


func (c *Container) Resize(size Size) 


Resize sets a new size for the Container. 


func (*Container) Show 


func (c *Container) Show() 


Show sets this container, and all its children, to be visible. 


func (*Container) Size 


func (c *Container) Size() Siz 


Size returns the current size of this container. 


func (*Container) Visible 


func (c *Container) Visible() bool 
Visible returns true if the container is currently visible, false otherwise. 
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fyne.Delta 


import "fyne.io/fyne/v2" 


Usage 


type Delta 


type Delta struct { 
DX, DY float32 
} 


Delta is a generic X, Y coordinate, size or movement representation. 


func NewDelta 


func NewDelta(dx float32, dy float32) Delta 


NewDelta returns a newly allocated Delta representing a movement in the X and Y axis. 


func (Delta) Components 


func (v Delta) Components() (float32, float32) 


Components returns the X and Y elements of this Delta. 


func (Delta) IsZero 


func (v Delta) IsZero() bool 
IsZero returns whether the Position is at the zero-point. 
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Fyne API "fyne.Device" 


fyne.Device 


import "fyne.io/fyne/v2" 


Usage 


type Device 


type Device interface { 
Orientation() DeviceOrientation 
IsMobile() bool 
HasKeyboard() bool 
SystemScaleForWindow (Window) float32 
} 


Device provides information about the devices the code is running on 


func CurrentDevice 


func CurrentDevice() Devic 


CurrentDevice returns the device information for the current hardware (via the driver) 
Tags: 
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Fyne API "fyne.DeviceOrientation"' 


fyne.DeviceOrientation 


import "fyne.io/fyne/v2" 


Usage 


type DeviceOrientation 


type DeviceOrientation int 


DeviceOrientation represents the different ways that a mobile device can be held 


const ( 


Tags: 


// OrientationVertical is the default vertical orientation 

OrientationVertical DeviceOrientation = iota 

// OrientationVerticalUpsideDown is the portrait orientation held upside down 
OrientationVerticalUpsideDown 

// OrientationHorizontalLeft is used to indicate a landscape orientation with the top to the left 
OrientationHorizontalLeft 

// OrientationHorizontalRight is used to indicate a landscape orientation with the top to the right 
OrientationHorizontalRight 
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fyne.Disableable 


import "fyne.io/fyne/v2" 


Usage 

type Disableable 

type Disableable interface { 
Enable () 
Disable () 
Disabled() bool 


} 


Disableable describes any CanvasObject that can be disabled. This is primarily used with objects that also 
implement the Tappable interface. 
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Fyne API "fyne.DoubleTappable" 


fyne.DoubleTappable 


import "fyne.io/fyne/v2" 


Usage 
type DoubleTappable 


type DoubleTappable interface { 
DoubleTapped (*PointEvent) 


} 
DoubleTappable describes any CanvasObject that can also be double tapped. 
Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


791 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


792 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


793 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


794 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


795 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


797 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


798 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


799 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "fyne.DragEvent" 


fyne.DragEvent 


import "fyne.io/fyne/v2" 


Usage 


type DragEvent 


type DragEvent struct { 
PointEvent 
Dragged Delta 


} 


DragEvent defines the parameters of a pointer or other drag event. The DraggedX and DraggedY fields 
show how far the item was dragged since the last event. 
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fyne.Draggable 


import "fyne.io/fyne/v2" 


Usage 
type Draggable 


type Draggable interface { 
Dragged (*DragEvent) 
DragEnd () 


} 


Draggable indicates that a CanvasObject can be dragged. This is used for any item that the user has 
indicated should be moved across the screen. 
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Fyne API "fyne.Driver" 


fyne.Driver 


import "fyne.io/fyne/v2" 


Usage 


type Driver 


type Driver interface { 
// CreateWindow creates a new UI Window. 
CreateWindow(string) Window 
// AllWindows returns a slice containing all app windows. 
AllWindows() []Window 


// RenderedTextSize returns the size required to render the given string of specified 
// font size and style. 
RenderedTextSize(string, float32, TextStyle) Size 


// CanvasForObject returns the canvas that is associated with a given CanvasObject. 

CanvasForObject (CanvasObject) Canvas 

// AbsolutePositionForObject returns the position of a given CanvasObject relative to the top/left of a canvas. 
AbsolutePositionForObject (CanvasObject) Position 


// Device returns the device that the application is currently running on. 


Device() Device 
// Run starts the main event loop of the driver. 
Run () 


// Quit closes the driver and open windows, then exit the application. 
// On some some operating systems this does nothing, for example iOS and Android. 
Quit () 


// StartAnimation registers a new animation with this driver and requests it be started. 
StartAnimation (*Animation) 

// StopAnimation stops an animation and unregisters from this driver. 

StopAnimation (*Animation) 


Driver defines an abstract concept of a Fyne render driver. Any implementation must provide at least these 
methods. 
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Fyne API "fyne.Focusable"' 


fyne.Focusable 


import "fyne.io/fyne/v2" 


Usage 


type Focusable 


type Focusable interface { 
// FocusGained is a hook called by the focus handling logic after this object gained the focus. 
FocusGained () 
// FocusLost is a hook called by the focus handling logic after this object lost the focus. 
FocusLost () 


// TypedRune is a hook called by the input handling logic on text input events if this object is focused. 
TypedRune (rune) 


// TypedKey is a hook called by the input handling logic on key events if this object is focused. 
TypedKey (*KeyEvent) 


Focusable describes any CanvasObject that can respond to being focused. It will receive the FocusGained 
and FocusLost events appropriately. When focused it will also have TypedRune called as text is input and 
TypedKey called when other keys are pressed. 


Note: You must not change canvas state (including overlays or focus) in FocusGained or FocusLost or you 
would end up with a dead-lock. 


Tags: 
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fyne.KeyEvent 


import "fyne.io/fyne/v2" 


Usage 


type KeyEvent 


type KeyEvent struct { 
Name KeyName 


} 
KeyEvent describes a keyboard input event. 
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Fyne API "fyne.KeyName"' 


fyne.KeyName 


import "fyne.io/fyne/v2" 


Usage 


type KeyName 


type KeyName string 


KeyName represents the name of a key that has been pressed 


const ( 
// KeyEscape is the "esc" key 
KeyEscape KeyName = "Escape" 
// KeyReturn is the carriage return (main keyboard) 
KeyReturn KeyName = "Return" 
// KeyTab is the tab advance key 
KeyTab KeyName = "Tab" 
// KeyBackspace is the delete-before-cursor key 
KeyBackspace KeyName = "BackSpace" 
// KeyInsert is the insert mode key 
KeyInsert KeyName = "Insert" 
// KeyDelete is the delete-after-cursor key 
KeyDelete KeyName = "Delete" 
// KeyRight is the right arrow key 
KeyRight KeyName = "Right" 
// KeyLeft is the left arrow key 
KeyLeft KeyName = "Left" 
// KeyDown is the down arrow key 
KeyDown KeyName = "Down" 
// KeyUp is the up arrow key 
KeyUp KeyName = "Up" 
// KeyPageUp is the page up num-pad key 
KeyPageUp KeyName = "Prior" 
// KeyPageDown is the page down num-pad key 
KeyPageDown KeyName = "Next" 
// KeyHome is the line-home key 
KeyHome KeyName = "Home" 
// KeyEnd is the line-end key 
KeyEnd KeyName = "End" 
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// KeyFl is the first function key 
KeyFl KeyName = "F1" 

// KeyF2 is the second function key 
KeyF2 KeyName = "F2" 

// KeyF3 is the third function key 
KeyF3 KeyName = "F3" 

// KeyF4 is the fourth function key 
KeyF4 KeyName = "F4" 

// KeyF5 is the fifth function key 
KeyF5 KeyName = "F5" 

// KeyF6 is the sixth function key 
KeyF6 KeyName = "F6" 

// KeyF7 is the seventh function key 
KeyF7 KeyName = "F7" 

// KeyF8 is the eighth function key 
KeyF8 KeyName = "F8" 

// KeyF9 is the ninth function key 
KeyF9 KeyName = "F9" 

// KeyF10 is the tenth function key 
KeyF10 KeyName = "F10" 

// KeyF1l1 is the eleventh function key 
KeyF1ll KeyName = "F11" 

// KeyF12 is the twelfth function key 
KeyF12 KeyName = "F12" 


// KeyEnter is the enter/ return key (keypad) 
KeyEnter KeyName = "KP_Enter" 


// KeyO represents the key 0 
KeyO KeyName = "0" 
// Keyl represents the key 1 
Keyl KeyName = "1" 
// Key2 represents the key 2 
Key2 KeyName = "2" 
// Key3 represents the key 3 
Key3 KeyName = "3" 
// Key4 represents the key 4 
Key4 KeyName = "4" 
// Key5 represents the key 5 
Key5 KeyName = "5" 
// Key6 represents the key 6 
Key6 KeyName = "6" 
// Key7 represents the key 7 
Key7 KeyName = "7" 
// Key8 represents the key 8 
Key8 KeyName = "8" 
// Key9 represents the key 9 
Key9 KeyName = "9" 
// KeyA represents the key A 
KeyA KeyName = "A" 
// KeyB represents the key B 
KeyB KeyName = "B" 
// KeyC represents the key C 
KeyC KeyName = "C" 
// KeyD represents the key D 
KeyD KeyName = "D" 
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tH 


y 


(full stop) 


// KeyE represents the key 
KeyE KeyName = "EK" 

// KeyF represents the key 
KeyF KeyName = "F" 

// KeyG represents the key 
KeyG KeyName = "G" 

// KeyH represents the key 
KeyH KeyName = "H" 

// KeyI represents the key 
KeyI KeyName = "I" 

// Keyd represents the key 
KeyJ KeyName = "J" 

// KeyK represents the key 
KeyK KeyName = "K" 

// KeyL represents the key 
KeyL KeyName = "L" 

// KeyM represents the key 
KeyM KeyName = "M" 

// KeyN represents the key 
KeyN KeyName = "N" 

// KeyO represents the key 
KeyO KeyName = "0" 

// KeyP represents the key 
KeyP KeyName = "P" 

// KeyQ represents the key 
KeyQ KeyName = "Q" 

// KeyR represents the key 
KeyR KeyName = "R" 

// KeyS represents the key 
KeyS KeyName = "S" 

// KeyT represents the key 
KeyT KeyName = "T" 

// KeyU represents the key 
KeyU KeyName = "U" 

// KeyV represents the key 
KeyV KeyName = "Vv" 

// KeyW represents the key 
KeyW KeyName = "W" 

// KeyX represents the key 
KeyX KeyName = "X" 

// KeyY represents the key 
KeyY KeyName = "Y" 

// KeyZ represents the key 
KeyZ KeyName = "Z" 

// KeySpace is the space k 
KeySpace KeyName = "Space" 
// KeyApostrophe is the key "’" 
KeyApostrophe KeyName = "/" 
// KeyComma is the key "," 
KeyComma KeyName = "," 

// KeyMinus is the key "-" 
KeyMinus KeyName = "-" 

// KeyPeriod is the key "." 
KeyPeriod KeyName wet 

// KeySlash is the key "/" 
KeySlash KeyName = "/" 
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// KeyBackslash is the key "\" 
KeyBackslash KeyName = "\\" 

// KeyLeftBracket is the key "[" 
KeyLeftBracket KeyName = "[" 

// KeyRightBracket is the key "]" 
KeyRightBracket KeyName = "]" 

// KeySemicolon is the key ";" 
KeySemicolon KeyName = ";" 

// KeyEqual is the key "=" 

KeyEqual KeyName = "=" 

// KeyAsterisk is the keypad key "*" 


KeyAsterisk KeyName = "*" 

// KeyPlus is the keypad key "+" 

KeyPlus KeyName = "+" 

// KeyBackTick is the key "*" on a US keyboard 
KeyBackTick KeyName = "‘" 


) 
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Fyne API "'fyne.Layout"' 


fyne.Layout 


import "fyne.io/fyne/v2" 


Usage 


type Layout 


type Layout interface { 


} 


// Layout will manipulate the listed CanvasObjects Size and Position 
// to fit within the specified size. 

Layout ([]CanvasObject, Size) 

// MinSize calculates the smallest size that will fit the listed 

// CanvasObjects using this Layout algorithm. 

MinSize(objects []CanvasObject) Size 


Layout defines how CanvasObjects may be laid out in a specified Size. 
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fyne.LegacyTheme 


import "fyne.io/fyne/v2" 


Usage 


type Legacy Theme 


type LegacyTheme interface { 
BackgroundColor() color.Color 
ButtonColor() color.Color 
DisabledButtonColor() color.Color 
TextColor() color.Color 
DisabledTextColor() color.Color 
PlaceHolderColor() color.Color 
PrimaryColor() color.Color 
HoverColor() color.Color 
FocusColor() color.Color 
ScrollBarColor() color.Color 
ShadowColor() color.Color 


TextSize() int 

TextFont() Resource 
TextBoldFont() Resource 
TextItalicFont() Resource 
TextBoldItalicFont() Resource 
TextMonospaceFont () Resource 


Padding() int 


IconInlineSize() int 
ScrollBarSize() int 
ScrollBarSmallSize() int 


LegacyTheme defines the requirements of any Fyne theme. This was previously called Theme and is kept 
for simpler transition of applications built before v2.0.0. 
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Fyne API "fyne.ListableURI" 


fyne.ListableURI 


import "fyne.io/fyne/v2" 


Usage 
type ListableURI 


type ListableURI interface { 
URI 


// List returns a list of child URIs of this URI. 
List() ([]URI, error) 
} 


ListableURI represents a URI that can have child items, most commonly a directory on disk in the native 
filesystem. 
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fyne.MainMenu 


import "fyne.io/fyne/v2" 


Usage 


type MainMenu 


type MainMenu struct { 
Items []*Menu 


} 


MainMenu defines the data required to show a menu bar (desktop) or other appropriate top level menu. 


func NewMainMenu 


func NewMainMenu(items ...*Menu) *MainMenu 


NewMainMenu creates a top level menu structure used by fyne. Window for displaying a menubar (or 
appropriate equivalent). 
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fyne.Menu 


import "fyne.io/fyne/v2" 


Usage 


type Menu 


type Menu struct { 
Label string 
Items []*MenuItem 


} 


Menu stores the information required for a standard menu. A menu can pop down from a MainMenu or 
could be a pop out menu. 


func NewMenu 


func NewMenu(label string, items ...*MenuItem) *Menu 


NewMent creates a new menu given the specified label (to show in a MainMenu) and list of items to 
display. 
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Fyne API "fyne.Menultem"' 


fyne.Menultem 


import "fyne.io/fyne/v2" 


Usage 


type Menultem 


type MenulItem struct { 
ChildMenu *Menu 
IsSeparator bool 
Label string 
Action func () 


} 


Menultem is a single item within any menu, it contains a display Label and Action function that is called 
when tapped. 


func NewMenultem 


func NewMenulItem(label string, action func()) *MenuItem 


NewMenultem creates a new menu item from the passed label and action parameters. 


func NewMenulItemSeparator 


func NewMenultemSeparator() *MenuItem 
NewMenultemSeparator creates a menu item that is to be used as a separator. 
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Fyne API "fyne.Notification" 


fyne.Notification 


import "fyne.io/fyne/v2" 


Usage 


type Notification 


type Notification struct { 
Title, Content string 
} 


Notification represents a user notification that can be sent to the operating system. 


func NewNotification 


func NewNotification(title, content string) *Notification 
NewNotification creates a notification that can be passed to App.SendNotification. 
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fyne.OverlayStack 


import "fyne.io/fyne/v2" 


Usage 


type OverlayStack 


type OverlayStack interface { 
// Add adds an overlay on the top of the overlay stack. 
Add(overlay CanvasObject) 
// List returns the overlays currently on the overlay stack. 
List() []CanvasObject 
// Remove removes the given object and all objects above it from the overlay stack. 
Remove (overlay CanvasObject) 
// Top returns the top-most object of the overlay stack. 
Top() CanvasObject 
} 


OverlayStack is a stack of CanvasObjects intended to be used as overlays of a Canvas. 
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fyne.PointEvent 


import "fyne.io/fyne/v2" 


Usage 


type PointEvent 


type PointEvent struct { 
AbsolutePosition Position // The absolute position of the event 
Position Position // The relative position of the event 


} 


PointEvent describes a pointer input event. The position is relative to the top-left of the CanvasObject this 
is triggered on. 
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Fyne API "fyne.Position" 


fyne.Position 


import "fyne.io/fyne/v2" 


Usage 


type Position 


type Position struct { 
X float32 // The position from the parent’s left edg 
Y float32 // The position from the parent’s top edge 


} 


Position describes a generic X, Y coordinate relative to a parent Canvas or CanvasObject. 


func NewPos 


func NewPos(x float32, y float32) Position 


NewPos returns a newly allocated Position representing the specified coordinates. 


func (Position) Add 


func (p Position) Add(v Vector2) Position 


Add returns a new Position that is the result of offsetting the current position by p2 X and Y. 


func (Position) Components 


func (p Position) Components() (float32, float32) 


Components returns the X and Y elements of this Position 
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func (Position) IsZero 


func (p Position) IsZero() bool 


IsZero returns whether the Position is at the zero-point. 


func (Position) Subtract 


func (p Position) Subtract(v Vector2) Position 
Subtract returns a new Position that is the result of offsetting the current position by p2 -X and -Y. 
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Fyne API "fyne.Preferences"' 


fyne.Preferences 


import "fyne.io/fyne/v2" 


Usage 


type Preferences 


type Preferences interface { 
// Bool looks up a boolean value for the key 
Bool (key string) bool 


// BoolWithFallback looks up a boolean value and returns the given fallback if not found 


BoolWithFallback(key string, fallback bool) bool 
// SetBool saves a boolean value for the given key 
SetBool (key string, value bool) 


// Float looks up a float64 value for the key 

Float (key string) float64 

// FloatWithFallback looks up a float64 value and returns the given fallback 
FloatWithFallback(key string, fallback float64) floaté64 

// SetFloat saves a float64 value for the given key 

SetFloat (key string, value float64) 


// Int looks up an integer value for the key 
Int (key string) int 


if not found 


// IntWithFallback looks up an integer value and returns the given fallback if not found 


IntWithFallback(key string, fallback int) int 
// SetInt saves an integer value for the given key 
SetInt (key string, value int) 


// String looks up a string value for the key 

String(key string) string 

// StringWithFallback looks up a string value and returns the given fallback 
StringWithFallback (key, fallback string) string 

// SetString saves a string value for the given key 

SetString(key string, value string) 


// RemoveValue removes a value for the given key (not currently supported on 
RemoveValue (key string) 


// AddChangeListener allows code to be notified when some preferences change. 


AddChangeListener (func () ) 


Preferences describes the ways that an app can save and load user preferences 
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This will fire on any update. 
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Fyne API "fyne.Resource"' 


fyne.Resource 


import "fyne.io/fyne/v2" 


Usage 


type Resource 


type Resource interface { 
Name() string 
Content () []byte 


} 


Resource represents a single binary resource, such as an image or font. A resource has an identifying name 
and byte array content. The serialised path of a resource can be obtained which may result in a blocking 
filesystem write operation. 


func LoadResourceFromPath 


func LoadResourceFromPath(path string) (Resource, error) 


LoadResourceFromPath creates a new StaticResource in memory using the contents of the specified file. 


func LoadResourceFromURLString 


func LoadResourceFromURLString(urlStr string) (Resource, error) 


LoadResourceFromURLString creates a new StaticResource in memory using the body of the specified 
URL. 
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Fyne API "fyne.ScrollEvent"' 


fyne.ScrollEvent 


import "fyne.io/fyne/v2" 


Usage 


type ScrollEvent 


type ScrollEvent struct { 
PointEvent 
Scrolled Delta 


} 


ScrollEvent defines the parameters of a pointer or other scroll event. The DeltaX and DeltaY represent 
how large the scroll was in two dimensions. 
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Fyne API "fyne.Scrollable"' 


fyne.Scrollable 


import "fyne.io/fyne/v2" 


Usage 
type Scrollable 


type Scrollable interface { 
Scrolled(*ScrollEvent) 


} 


Scrollable describes any CanvasObject that can also be scrolled. This is mostly used to implement the 
widget.ScrollContainer. 
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Fyne API "'fyne.SecondaryTappable"' 


fyne.SecondaryTappable 


import "fyne.io/fyne/v2" 


Usage 
type SecondaryTappable 


type SecondaryTappable interface { 
TappedSecondary (*PointEvent) 


} 
SecondaryTappable describes a CanvasObject that can be right-clicked or long-tapped. 
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Fyne API "'fyne.Settings"' 


fyne.Settings 


import "fyne.io/fyne/v2" 


Usage 


type Settings 


type Settings interface { 
Theme() Theme 
Set Theme (Theme) 
// ThemeVariant defines which preferred version of a theme should be used (i.e. light or dark) 
// 
// Since: 2.0 
ThemeVariant () ThemeVariant 
Scale() float32 
// PrimaryColor indicates a user preference for a named primary color 
// 
// Since: 1.4 
PrimaryColor() string 


AddChangeListener (chan Settings) 
BuildType() BuildType 


Settings describes the application configuration available. 
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Fyne API "fyne.Shortcut" 


fyne.Shortcut 


import "fyne.io/fyne/v2" 


Usage 


type Shortcut 


type Shortcut interface { 
ShortcutName() string 


} 
Shortcut is the interface used to describe a shortcut action 
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fyne.ShortcutCopy 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutCopy 


type ShortcutCopy struct { 
Clipboard Clipboard 
} 


ShortcutCopy describes a shortcut copy action. 


func (*ShortcutCopy) ShortcutName 


func (se *ShortcutCopy) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.ShortcutCut" 


fyne.ShortcutCut 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutCut 


type ShortcutCut struct { 
Clipboard Clipboard 
} 


ShortcutCut describes a shortcut cut action. 


func (*ShortcutCut) ShortcutName 


func (se *ShortcutCut) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.ShortcutHandler"' 


fyne.ShortcutHandler 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutHandler 


type ShortcutHandler struct { 
} 


ShortcutHandler is a default implementation of the shortcut handler for the canvasObject 


func (*ShortcutHandler) AddShortcut 


func (sh *ShortcutHandler) AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
AddShortcut register an handler to be executed when the shortcut action is triggered 

func (*ShortcutHandler) RemoveShortcut 

func (sh *ShortcutHandler) RemoveShortcut (shortcut Shortcut) 

RemoveShortcut removes a registered shortcut 

func (*ShortcutHandler) TypedShortcut 

func (sh *ShortcutHandler) TypedShortcut (shortcut Shortcut) 

TypedShortcut handle the registered shortcut 
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Fyne API "fyne.ShortcutPaste"' 


fyne.ShortcutPaste 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutPaste 


type ShortcutPaste struct { 
Clipboard Clipboard 
} 


ShortcutPaste describes a shortcut paste action. 


func (*ShortcutPaste) ShortcutName 


func (se *ShortcutPaste) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "'fyne.ShortcutSelectAll"' 


fyne.ShortcutSelectAll 


import "fyne.io/fyne/v2" 


Usage 
type ShortcutSelectAll 
type ShortcutSelectAll struct{} 


ShortcutSelectAll describes a shortcut selectAll action. 


func (*ShortcutSelectAll) ShortcutName 


func (se *ShortcutSelectAll) ShortcutName() string 
ShortcutName returns the shortcut name 
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fyne.Shortcutable 


import "fyne.io/fyne/v2" 


Usage 


type Shortcutable 


type Shortcutable interface { 
TypedShortcut (Shortcut) 
} 


Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and 
paste). 
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Fyne API "fyne.Size" 


fyne.Size 


import "fyne.io/fyne/v2" 


Usage 


type Size 


type Size struct { 
Width float32 // The number of units along the X axis. 
Height float32 // The number of units along the Y axis. 


} 


Size describes something with width and height. 


func MeasureText 


func MeasureText (text string, size float32, style TextStyle) Siz 


MeasureText uses the current driver to calculate the size of text when rendered. 


func NewSize 


func NewSize(w float32, h float32) Size 


NewSize returns a newly allocated Size of the specified dimensions. 


func (Size) Add 


func (s Size) Add(v Vector2) Size 


Add returns a new Size that is the result of increasing the current size by s2 Width and Height. 
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func (Size) Components 


func (s Size) Components() (float32, float32) 


Components returns the Width and Height elements of this Size 


func (Size) IsZero 


func (s Size) IsZero() bool 


IsZero returns whether the Size has zero width and zero height. 


func (Size) Max 


func (s Size) Max(v Vector2) Size 

Max returns a new Size that is the maximum of the current Size and s2. 
func (Size) Min 

func (s Size) Min(v Vector2) Size 


Min returns a new Size that is the minimum of the current Size and s2. 


func (Size) Subtract 


func (s Size) Subtract(v Vector2) Size 
Subtract returns a new Size that is the result of decreasing the current size by s2 Width and Height. 
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Fyne API "fyne.StaticResource"' 


fyne.StaticResource 


import "fyne.io/fyne/v2" 


Usage 


type StaticResource 


type StaticResource struct { 
StaticName string 
StaticContent []byte 
} 


StaticResource is a bundled resource compiled into the application. These resources are normally 
generated by the fyne_bundle command included in the Fyne toolkit. 


func NewStaticResource 
func NewStaticResource(name string, content []byte) *StaticResource 


NewStaticResource returns a new static resource object with the specified name and content. Creating a 
new Static resource in memory results in sharable binary data that may be serialised to the location 
returned by CachePath(). 

func (*StaticResource) Content 


func (r *StaticResource) Content() []byte 


Content returns the bytes of the bundled resource, no compression is applied but any compression on the 
resource is retained. 


func (*StaticResource) GoString 


func (r *StaticResource) GoString() string 


GoString converts a Resource object to Go code. This is useful if serialising to a Go file for compilation 
into a binary. 
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func (*StaticResource) Name 


func (r *StaticResource) Name() string 
Name returns the unique name of this resource, usually matching the file it was generated from. 
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Fyne API "'fyne.Storage" 


fyne.Storage 


import "fyne.io/fyne/v2" 


Usage 


type Storage 


type Storage interface { 
RootURI() URI 
} 


Storage is used to manage file storage inside an application sandbox 
Tags: 
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Fyne API "fyne.StringValidator" 


fyne.String Validator 


import "fyne.io/fyne/v2" 


Usage 

type StringValidator 

type StringValidator func(string) error 

String Validator is a function signature for validating string inputs. 


Since: 1.4 
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Fyne API "fyne.Tappable"' 


fyne.Tappable 


import "fyne.io/fyne/v2" 


Usage 
type Tappable 


type Tappable interface { 
Tapped (*PointEvent) 


} 


Tappable describes any CanvasObject that can also be tapped. This should be implemented by buttons etc 
that wish to handle pointer interactions. 
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Fyne API "fyne.TextAlign" 


fyne.TextAlign 


import "fyne.io/fyne/v2" 


Usage 
type TextAlign 


type TextAlign int 


TextAlign represents the horizontal alignment of text within a widget or canvas object. 


const ( 
// TextAlignLeading specifies a left alignment for left-to-right languages. 
TextAlignLeading TextAlign = iota 
// TextAlignCenter places the text centrally within the available space. 
TextAlignCenter 
// TextAlignTrailing will align the text right for a left-to-right language. 
TextAlignTrailing 

) 
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fyne.TextStyle 


import "fyne.io/fyne/v2" 


Usage 


type TextStyle 

type TextStyle struct { 
Bold bool // Should text be bold 
Italic bool // Should text be italic 


Monospace bool // Use the system monospace font instead of regular 


} 
TextStyle represents the styles that can be applied to a text canvas object or text based widget. 
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fyne.TextWrap 


import "fyne.io/fyne/v2" 


Usage 
type TextWrap 


type TextWrap int 


TextWrap represents how text longer than the widgetas width will be wrapped. 


const ( 
// TextWrapOff extends the widget’s width to fit the text, no wrapping is applied. 
TextWrapOff TextWrap = iota 
// TextTruncate trims the text to the widget’s width, no wrapping is applied. 
// Tf an entry is asked to truncate it will provide scrolling capabilities. 
TextTruncate 
// TextWrapBreak trims the line of characters to the widget’s width adding the excess as new line. 
// An Entry with text wrapping will scroll vertically if there is not enough space for all the text. 
TextWrapBreak 
// TextWrapWord trims the line of words to the widget’s width adding the excess as new line. 
// An Entry with text wrapping will scroll vertically if there is not enough space for all the text. 
TextWrapWord 
) 
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fyne. Theme 


import "fyne.io/fyne/v2" 


Usage 


type Theme 


type Theme interface { 
Color (ThemeColorName, ThemeVariant) color.Color 
Font (TextStyle) Resourc 
Icon(ThemeIconName) Resource 
Size(ThemeSizeName) float32 


} 
Theme defines the method to look up colors, sizes and fonts that make up a Fyne theme. 
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e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodelD][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "fyne.ThemeColorName" 


fyne. ThemeColorName 


import "fyne.io/fyne/v2" 


Usage 

type ThemeColorName 

type ThemeColorName string 

ThemeColorName is used to look up a colour based on its name. 


Since: 2.0 
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If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


1150 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1151 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1152 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 
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KeyboardShortcut|[p 2852] 
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o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
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© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023} 


Fyne API "fyne.ThemeIconName"' 


fyne. ThemeIconName 


import "fyne.io/fyne/v2" 


Usage 

type ThemeIconName 

type ThemeIconName string 

ThemelIconName is used to look up an icon based on its name. 


Since: 2.0 
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Fyne API "fyne.ThemeSizeName"' 


fyne. ThemeSizeName 


import "fyne.io/fyne/v2" 


Usage 


type ThemeSizeName 


type ThemeSizeName string 


ThemeSizeName is used to look up a size based on its name. 
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Fyne API "fyne.Theme Variant" 


fyne. Theme Variant 


import "fyne.io/fyne/v2" 


Usage 

type ThemeVariant 

type ThemeVariant uint 

ThemeVariant indicates a variation of a theme, such as light or dark. 
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Fyne API "fyne.URI" 


fyne.URI 


import "fyne.io/fyne/v2" 


Usage 
type URI 


type URI interface { 
fmt .Stringer 


// Extension should return the file extension of the resource 

// referenced by the URI. For example, the Extension() of 

// 'file://foo/bar.baz’ is 'baz’. May return an empty string if the 
// cveferenced resource has none. 

Extension() string 


// Name should return the base name of the item referenced by the URI. 
// For example, the Name() of '’file://foo/bar.baz’ is 'bar.baz’. 
Name() string 


// MimeType should return the content type of the resource referenced 
// by the URI. The returned string should be in the format described 
// by Section 5 of RFC2045 ("Content-Type Header Field"). 

MimeType() string 


// Scheme should return the URI scheme of the URI as defined by IETF 
// RFC3986. For example, the Scheme() of 'file://foo/bar.baz* is 


// ‘file’. 

// 

// Scheme should always return the scheme in all lower-case characters. 
Scheme() string 


// Authority should return the URI authority, as defined by IETF 

// RFC3986. 

// 

// NOTE: the RFC3986 can be obtained by combining the User and Host 
// Fields of net/url’s URL structure. Consult IETF RFC3986, section 
f/--3.2, ppe 1Ts 

// 

// Since: 2.0 
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Authority() string 


// Path should return the URI path, 


// 
// Since: 2.0 
Path() string 


// Query should return the URI query, 


// 
// Since: 2.0 
Query() string 


// Fragment should return the URI fragment, 


// RFC3986. 

“ah 

// Since: 2.0 
Fragment () string 


} 


as defined by I! 


as defined by II 


as defined by II 


ETF RFC3986. 


ETF RFC3986. 


ETE 


URI represents the identifier of a resource on a target system. This resource may be a file or another data 


source such as an app or file sharing system. 


In general, it is expected that URI implementations follow IETF RFC3896. Implementations are highly 
recommended to utilize net/url to implement URI parsing methods, especially Scheme(), AUthorityQ, 


Path(), Query(), and Fragment(). 
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fyne. URIReadCloser 


import "fyne.io/fyne/v2" 


Usage 
type URIReadCloser 


type URIReadCloser interface { 
io.ReadCloser 


URI() URI 
} 


URIReadCloser represents a cross platform data stream from a file or provider of data. It may refer to an 
item on a filesystem or data in another application that we have access to. 
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fyne.URIWriteCloser 


import "fyne.io/fyne/v2" 


Usage 
type URIWriteCloser 


type URIWriteCloser interface { 
io.WriteCloser 


URI() URI 
} 


URIWriteCloser represents a cross platform data writer for a file resource. This will normally refer to a 
local file resource. 
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fyne. Validatable 


import "fyne.io/fyne/v2" 


Usage 
type Validatable 


type Validatable interface { 
Validate() error 


// SetOnValidationChanged is used to set the callback that will be triggered when the validation state changes. 
// The function might be overwritten by a parent that cares about child validation (e.g. widget.Form). 
SetOnValidationChanged (func (error) ) 

} 


Validatable is an interface for specifying if a widget is validatable. 
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fyne.Vector2 


import "fyne.io/fyne/v2" 


Usage 


type Vector2 


type Vector2 interface { 
Components() (float32, float32) 
IsZero() bool 
} 
Vector2 marks geometry types that can operate as a coordinate vector. 
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Fyne API "'fyne. Widget" 


fyne. Widget 


import "fyne.io/fyne/v2" 


Usage 
type Widget 


type Widget interface { 
CanvasObject 


// CreateRenderer returns a new WidgetRenderer for this widget. 
// This should not be called by regular code, it is used internally to render a widget. 


CreateRenderer() WidgetRenderer 


} 


Widget defines the standard behaviours of any widget. This extends the CanvasObject - a widget behaves 
in the same basic way but will encapsulate many child objects to create the rendered widget. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


1232 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1233 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1234 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


1235 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


1236 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


1237 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


1238 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


1239 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


1240 


® |ToolbarSpacer}[p 4993] 
@ [p 5002] 
@ |TreeNodeID|[p 5014] 


@ [List My App][p 5023] 
Fyne API "fyne.WidgetRenderer"' 


fyne.WidgetRenderer 


import "fyne.io/fyne/v2" 


Usage 


type WidgetRenderer 


type WidgetRenderer interface { 


// Destroy is for internal use. 

Destroy () 

// Layout is a hook that is called if the widget needs to be laid out. 

// This should never call Refresh. 

Layout (Size) 

// MinSize returns the minimum size of the widget that is rendered by this renderer. 
MinSize() Size 

// Objects returns all objects that should be drawn. 

Objects() []CanvasObject 

// Refresh is a hook that is called if the widget has updated and needs to be redrawn. 
// This might trigger a Layout. 

Refresh () 


WidgetRenderer defines the behaviour of a widgetas implementation. This is returned from a widgetas 
declarative object through the CreateRenderer() function and should be exactly one instance per widget in 


memory. 
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Fyne API "fyne.Window"' 


fyne.Window 


import "fyne.io/fyne/v2" 


Usage 
type Window 


type Window interface { 
// Title returns the current window title. 
// This is typically displayed in the window decorations. 
Title() string 
// SetTitle updates the current title of the window. 
SetTitle (string) 


// FullScreen returns whether or not this window is currently full screen. 
FullScreen() bool 

// SetFullScreen changes the requested fullScreen property 

// true for a fullScreen window and false to unset this. 

SetFullScreen (bool) 


// Resize this window to the requested content siz 

// The result may not be exactly as desired due to various desktop or 
// platform constraints. 

Resize (Size) 


// RequestFocus attempts to raise and focus this window. 

// This should only be called when you are sure the user would want this window 
// to steal focus from any current focused window. 

RequestFocus () 


// FixedSize returns whether or not this window should disable resizing. 
FixedSize() bool 

// SetFixedSize sets a hint that states whether the window should be a fixed 
// size or allow resizing. 

SetFixedSize (bool) 


// CenterOnScreen places a window at the center of the monitor 
// the Window object is currently positioned on. 
CenterOnScreen () 
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// Padded, normally true, states whether the window should have inner 

// padding so that components do not touch the window edge. 

Padded() bool 

// SetPadded allows applications to specify that a window should have 

// no inner padding. Useful for fullscreen or graphic based applications. 
SetPadded (bool) 


// Tcon returns the window icon, this is used in various ways 

// depending on operating system. 

// Most commonly this is displayed on the window border or task switcher. 
Icon() Resource 


// SetIcon sets the icon resource used for this window. 
// Tf none is set should return the application icon. 
SetIcon (Resource) 


// SetMaster indicates that closing this window should exit the app 
SetMaster () 


// MainMenu gets the content of the window’s top level menu. 
MainMenu() *MainMenu 


// SetMainMenu adds a top level menu to this window. 
// The way this is rendered will depend on the loaded driver. 
SetMainMenu (*MainMenu) 


// SetOnClosed sets a function that runs when the window is closed. 
SetOnClosed (func () ) 


// SetCloseIntercept sets a function that runs instead of closing if defined. 
// Close() should be called explicitly in the interceptor to close the window. 
// 

// Since: 1.4 

SetCloseIntercept (func () ) 


// Show the window on screen. 

Show () 

// Hide the window from the user. 

// This will not destroy the window or cause the app to exit. 

Hide () 

// Close the window. 

// If it is the only open window, or the "master" window the app will Quit. 
Close () 


// ShowAndRun is a shortcut to show the window and then run the application. 
// This should be called near th nd of a main() function as it will block. 
ShowAndRun () 


// Content returns the content of this window. 

Content () CanvasObject 

// SetContent sets the content of this window. 

SetContent (CanvasObject) 

// Canvas returns the canvas context to render in the window. 

// This can be useful to set a key handler for the window, for example. 
Canvas() Canvas 
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// Clipboard returns the system clipboard 
Clipboard() Clipboard 


Window describes a user interface window. Depending on the platform an app may have many windows 


or just the one. 
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If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 
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fyne 


import "fyne.io/fyne" 


Package fyne describes the objects and components available to any Fyne app. These can all be created, 
manipulated and tested without rendering (for speed). Your main package should use the app package to 
create an application with a default driver that will render your UI. 


A simple application may look like this: 
package main 


import "fyne.io/fyne/app" 
import "fyne.io/fyne/widget" 


func main() { 
a := app.New() 
w := a.NewWindow ("Hello") 
hello := widget.NewLabel ("Hello Fyne!") 
w.SetContent (widget .NewVBox ( 
hello, 


widget .NewButton("Hi!", func() { 
hello.SetText ("Welcome :)") 


}), 
)) 


w.ShowAndRun () 


Usage 


const SettingsScaleAuto = float32(-1.0) 


SettingsScaleAuto is a specific scale value that indicates a canvas should scale according to the DPI of the 


window that contains it. 


Deprecated: Automatic scaling is now handled in the drivers and is not a user setting. 
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func IsHorizontal 


func IsHorizontal (orient DeviceOrientation) bool 


IsHorizontal is a helper utility that determines if a passed orientation is horizontal 


func IsVertical 


func IsVertical(orient DeviceOrientation) bool 


IsVertical is a helper utility that determines if a passed orientation is vertical 


func LogError 


func LogError(reason string, err error) 


LogError reports an error to the command line with the specified err cause, if not nil. The function also 
reports basic information about the code location. 
func Max 


func Max(x, y int) int 


Max returns the larger of the passed values. 


func Min 


func Min(x, y int) int 
Min returns the smaller of the passed values. 


func SetCurrentApp 


func SetCurrentApp (current App) 


SetCurrentApp is an internal function to set the app instance currently running. 
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Fyne API "fyne.App" 
[Edit me] 


fyne.App 


import "fyne.io/fyne" 


Usage 


type App 


type App interface { 
// Create a new window for the application. 
// The first window to open is considered the "master" and when closed 
// the application will exit. 
NewWindow(title string) Window 


// Open a URL in the default browser application. 
OpenURL (url *url.URL) error 


// Icon returns the application icon, this is used in various ways 
// depending on operating system. 

// This is also the default icon for new windows. 

Icon() Resource 


// SetIcon sets the icon resource used for this application instance. 
SetIcon (Resource) 


// Run the application - this starts the event loop and waits until Quit () 
// is called or the last window closes. 

// This should be called near the end of a main() function as it will block. 
Run () 


// Calling Quit on the application will cause the application to exit 

// cleanly, closing all open windows. 

// This function does no thing on a mobile device as the application lifecycle is 
// managed by the operating system. 

Quit () 


// Driver returns the driver that is rendering this application. 
// Typically not needed for day to day work, mostly internal functionality. 
Driver() Driver 


// UniqueID returns the application unique identifier, if set. 
// This must be set for use of the Preferences() functions... see NewWithId(string) 


UniqueID() string 


// SendNotification sends a system notification that will be displayed in the operating system’s notification area. 
SendNotification (*Notification) 


// Settings return the globally set settings, determining theme and so on. 
Settings() Settings 


// Preferences returns the application preferences, used for storing configuration and state 
Preferences() Preferences 
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// Storage returns a storage handler specific to this application. 
Storage() Storage 


An App is the definition of a graphical application. Apps can have multiple windows, it will exit when the 
first window to be shown is closed. You can also cause the app to exit by calling Quit(). To start an 
application you need to call Run() somewhere in your main() function. Alternatively use the 
window.ShowAndRun() function for your main window. 


func CurrentApp 


func CurrentApp() App 


CurrentApp returns the current application, for which there is only 1 per process. 
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fyne.BuildType 


import "fyne.io/fyne" 


Usage 


type BuildType 


type BuildType int 


BuildType defines different modes that an application can be built using. 


const ( 


Tags: 


// BuildStandard is the normal build mode - it is not debug, test or release mode. 

BuildStandard BuildType = iota 

// BuildDebug is used when a developer would like more information and visual output for app debugging. 
BuildDebug 

// BuildRelease is a final production build, it is like BuildStandard but will use distribution certificates. 
// A release build is typically going to connect to live services and is not usually used during development. 
BuildRelease 
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Fyne API '"'fyne.Canvas"' 


fyne.Canvas 


import "fyne.io/fyne" 


Usage 


type Canvas 


type Canvas interface { 
Content () CanvasObject 
SetContent (CanvasObject) 


Refresh (CanvasObject) 


// Focus makes the provided item focused. 

// The item has to be added to the contents of the canvas before calling this. 
Focus (Focusable) 

Unfocus () 

Focused() Focusable 


// Size returns the current size of this canvas 

Size() Size 

// Scale returns the current scale (multiplication factor) this canvas uses to render 

// The pixel size of a CanvasObject can be found by multiplying by this value. 

Scale() float32 

// SetScale sets ths scale for this canvas only, overriding system and user settings. 

// 

// Deprecated: Settings are now calculated solely on the user configuration and system setup. 
SetScale (float32) 


// Overlay returns the current overlay. 

// 

// Deprecated: Overlays are stacked now. 

// This method returns the top of the overlay stack. 
// Use Overlays() instead. 

Overlay() CanvasObject 

// Overlays returns the overlay stack. 

Overlays() OverlayStack 

// SetOverlay sets the overlay for the canvas. 

// 

// Deprecated: Overlays are stacked now. 

// This method replaces the whole stack by the given overlay. 
// Use Overlays() instead. 

SetOverlay (CanvasObject) 


OnTypedRune() func (rune) 

SetOnTypedRune (func (rune) ) 

OnTypedKey() func (*KeyEvent) 

SetOnTypedKey (func (*KeyEvent) ) 

AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
RemoveShortcut (shortcut Shortcut) 


Capture() image.Image 
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// PixelCoordinateForPosition returns the x and y pixel coordinate for a given position on this canvas. 
// This can be used to find absolute pixel positions or pixel offsets relative to an object top left. 
PixelCoordinateForPosition(Position) (int, int) 


// InteractiveArea returns the position and size of the central interactive area. 
// Operating system elements may overlap the portions outside this area and widgets should avoid being outside. 


// 
// Since: 1.4 
InteractiveArea() (Position, Size) 


Canvas defines a graphical canvas to which a CanvasObject or Container can be added. Each canvas has a 
scale which is automatically applied during the render process. 
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fyne.CanvasObject 


import "fyne.io/fyne" 


Usage 


type CanvasObject 
type CanvasObject interface { 


// MinSize returns the minimum size this object needs to be drawn. 

MinSize() Size 

// Move moves this object to the given position relative to its parent. 

// This should only be called if your object is not in a container with a layout manager. 
Move (Position) 

// Position returns the current position of the object relative to its parent. 

Position() Position 

// Resize resizes this object to the given size. 

// This should only be called if your object is not in a container with a layout manager. 
Resize (Size) 

// Size returns the current size of this object. 

Size() Size 


// Hide hides this object. 

Hide () 

// Visible returns whether this object is visible or not. 
Visible() bool 

// Show shows this object. 

Show () 


// Refresh must be called if this object should be redrawn because its inner state changed. 
Refresh () 


CanvasObject describes any graphical object that can be added to a canvas. Objects have a size and 
position that can be controlled through this API. MinSize is used to determine the minimum size which 
this object should be displayed. An object will be visible by default but can be hidden with Hide() and 
re-shown with Show(). 


Note: If this object is controlled as part of a Layout you should not call Resize(Size) or Move(Position). 
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fyne.Clipboard 


import "fyne.io/fyne" 


Usage 
type Clipboard 


type Clipboard interface { 
// Content returns the clipboard content 
Content () string 
// SetContent sets the clipboard content 
SetContent (content string) 


} 
Clipboard represents the system clipboard interface 
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Fyne API "fyne.Container" 


fyne.Container 


import "fyne.io/fyne" 


Usage 


type Container 


type Container struct { 
Hidden bool // Is this Container hidden 


Layout Layout // The Layout algorithm for arranging child CanvasObjects 
Objects []CanvasObject // The set of CanvasObjects this container holds 


} 


Container is a CanvasObject that contains a collection of child objects. The layout of the children is set by 
the specified Layout. 


func NewContainer 


func NewContainer(objects ...CanvasObject) *Container 
NewContainer returns a new Container instance holding the specified CanvasObjects. 


Deprecated: Use NewContainerWithoutLayout to create a container that uses manual layout. 


func NewContainerWithLayout 


func NewContainerWithLayout (layout Layout, objects ...CanvasObject) *Container 


NewContainerWithLayout returns a new Container instance holding the specified CanvasObjects which 
will be laid out according to the specified Layout. 
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func NewContainerWithoutLayout 


func NewContainerWithoutLayout (objects ...CanvasObject) *Container 


NewContainerWithoutLayout returns a new Container instance holding the specified CanvasObjects that 
are manually arranged. 


func (*Container) Add 


func (c *Container) Add(add CanvasObject) 
Add appends the specified object to the items this container manages. 


Since: 1.4 


func (*Container) AddObject 


func (c *Container) AddObject (o CanvasObject) 
AddObject adds another CanvasObject to the set this Container holds. 


Deprecated: Use replacement Add() function 


func (*Container) Hide 

func (c *Container) Hide () 

Hide sets this container, and all its children, to be not visible. 
func (*Container) MinSize 

func (c *Container) MinSize() Size 


MinSize calculates the minimum size of a Container. This is delegated to the Layout, if specified, 
otherwise it will mimic MaxLayout. 


func (*Container) Move 


func (c *Container) Move(pos Position) 


Move the container (and all its children) to a new position, relative to its parent. 


func (*Container) Position 


func (c *Container) Position() Position 


Position gets the current position of this Container, relative to its parent. 
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func (*Container) Refresh 


func (c *Container) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Container) Remove 


func (c *Container) Remove(rem CanvasObject) 


Remove updates the contents of this container to no longer include the specified object. 


func (*Container) Resize 


func (c *Container) Resize(size Size) 


Resize sets a new size for the Container. 


func (*Container) Show 


func (c *Container) Show() 


Show sets this container, and all its children, to be visible. 


func (*Container) Size 


func (c *Container) Size() Siz 


Size returns the current size of this container. 


func (*Container) Visible 


func (c *Container) Visible() bool 
Visible returns true if the container is currently visible, false otherwise. 
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Fyne API "fyne.Device" 


fyne.Device 


import "fyne.io/fyne" 


Usage 


type Device 


type Device interface { 
Orientation() DeviceOrientation 
IsMobile() bool 
HasKeyboard() bool 
SystemScaleForWindow (Window) float32 


// Deprecated: Use SystemScaleForWindow instead - system scale can vary depending on window placement 
SystemScale() float32 
} 


Device provides information about the devices the code is running on 


func CurrentDevice 


func CurrentDevice() Devic 
CurrentDevice returns the device information for the current hardware (via the driver) 
Tags: 
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Fyne API "fyne.DeviceOrientation"' 


fyne.DeviceOrientation 


import "fyne.io/fyne" 


Usage 


type DeviceOrientation 


type DeviceOrientation int 


DeviceOrientation represents the different ways that a mobile device can be held 


const ( 


Tags: 


// OrientationVertical is the default vertical orientation 

OrientationVertical DeviceOrientation = iota 

// OrientationVerticalUpsideDown is the portrait orientation held upside down 
OrientationVerticalUpsideDown 

// OrientationHorizontalLeft is used to indicate a landscape orientation with the top to the left 
OrientationHorizontalLeft 

// OrientationHorizontalRight is used to indicate a landscape orientation with the top to the right 
OrientationHorizontalRight 
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fyne.Disableable 


import "fyne.io/fyne" 


Usage 

type Disableable 

type Disableable interface { 
Enable () 
Disable () 
Disabled() bool 


} 


Disableable describes any CanvasObject that can be disabled. This is primarily used with objects that also 
implement the Tappable interface. 
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fyne.DoubleTappable 


import "fyne.io/fyne" 


Usage 
type DoubleTappable 


type DoubleTappable interface { 
DoubleTapped (*PointEvent) 


} 
DoubleTappable describes any CanvasObject that can also be double tapped. 
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Fyne API "fyne.DragEvent" 


fyne.DragEvent 


import "fyne.io/fyne" 


Usage 


type DragEvent 


type DragEvent struct { 
PointEvent 
DraggedX, DraggedY int 


} 


DragEvent defines the parameters of a pointer or other drag event. The DraggedX and DraggedY fields 
show how far the item was dragged since the last event. 
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© [List My Applip 5023] 


Fyne API "fyne.Draggable"' 


fyne.Draggable 


import "fyne.io/fyne" 


Usage 
type Draggable 


type Draggable interface { 
Dragged (*DragEvent) 
DragEnd () 


} 


Draggable indicates that a CanvasObject can be dragged. This is used for any item that the user has 
indicated should be moved across the screen. 
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Fyne API "fyne.Driver" 


fyne.Driver 


import "fyne.io/fyne" 


Usage 


type Driver 


type Driver interface { 
// CreateWindow creates a new UI Window. 
CreateWindow(string) Window 
// AllWindows returns a slice containing all app windows. 
AllWindows() []Window 


// RenderedTextSize returns the size required to render the given string of specified 
// font size and style. 
RenderedTextSize(string, int, TextStyle) Size 


// FileReaderForURI opens a file reader for the given resource indicator. 
// This may refer to a filesystem (typical on desktop) or data from another application. 
FileReaderForURI (URI) (URIReadCloser, error 


// FileWriterForURI opens a file writer for the given resource indicator. 
// This should refer to a filesystem resource as external data will not be writable. 
FileWriterForURI(URI) (URIWriteCloser, error) 


// ListerForURI converts a URI to a listable URI, if it is possible to do so. 
ListerForURI(URI) (ListableURI, error) 


// CanvasForObject returns the canvas that is associated with a given CanvasObject. 

CanvasForObject (CanvasObject) Canvas 

// AbsolutePositionForObject returns the position of a given CanvasObject relative to the top/left of a canvas. 
AbsolutePositionForObject (CanvasObject) Position 


// Device returns the device that the application is currently running on. 


Device() Device 

// Run starts the main event loop of the driver. 

Run () 

// Quit closes the driver and open windows, then exit the application. 
Quit () 


Driver defines an abstract concept of a Fyne render driver. Any implementation must provide at least these 
methods. 
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Fyne API "fyne.Focusable"' 


fyne.Focusable 


import "fyne.io/fyne" 


Usage 


type Focusable 


type Focusable interface { 
// FocusGained is a hook called by the focus handling logic after this object gained the focus. 
FocusGained () 
// FocusLost is a hook called by the focus handling logic after this object lost the focus. 
FocusLost () 
// Deprecated: this is an internal detail, canvas tracks current focused object 
Focused() bool 


// TypedRune is a hook called by the input handling logic on text input events if this object is focused. 
TypedRune (rune) 


// TypedKey is a hook called by the input handling logic on key events if this object is focused. 
TypedKey (*KeyEvent) 


Focusable describes any CanvasObject that can respond to being focused. It will receive the FocusGained 
and FocusLost events appropriately. When focused it will also have TypedRune called as text is input and 
TypedKey called when other keys are pressed. 


Note: You must not change canvas state (including overlays or focus) in FocusGained or FocusLost or you 
would end up with a dead-lock. 
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fyne.KeyEvent 


import "fyne.io/fyne" 


Usage 


type KeyEvent 


type KeyEvent struct { 
Name KeyName 


} 
KeyEvent describes a keyboard input event. 
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© [List My Applip 5023] 


Fyne API "fyne.KeyName"' 


fyne.KeyName 


import "fyne.io/fyne" 


Usage 


type KeyName 


type KeyName string 


KeyName represents the name of a key that has been pressed 


const ( 
// KeyEscape is the "esc" key 
KeyEscape KeyName = "Escape" 
// KeyReturn is the carriage return (main keyboard) 
KeyReturn KeyName = "Return" 
// KeyTab is the tab advance key 
KeyTab KeyName = "Tab" 
// KeyBackspace is the delete-before-cursor key 
KeyBackspace KeyName = "BackSpace" 
// KeyInsert is the insert mode key 
KeyInsert KeyName = "Insert" 
// KeyDelete is the delete-after-cursor key 
KeyDelete KeyName = "Delete" 
// KeyRight is the right arrow key 
KeyRight KeyName = "Right" 
// KeyLeft is the left arrow key 
KeyLeft KeyName = "Left" 
// KeyDown is the down arrow key 
KeyDown KeyName = "Down" 
// KeyUp is the up arrow key 
KeyUp KeyName = "Up" 
// KeyPageUp is the page up num-pad key 
KeyPageUp KeyName = "Prior" 
// KeyPageDown is the page down num-pad key 
KeyPageDown KeyName = "Next" 
// KeyHome is the line-home key 
KeyHome KeyName = "Home" 
// KeyEnd is the line-end key 
KeyEnd KeyName = "End" 
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// KeyFl is the first function key 
KeyFl KeyName = "F1" 

// KeyF2 is the second function key 
KeyF2 KeyName = "F2" 

// KeyF3 is the third function key 
KeyF3 KeyName = "F3" 

// KeyF4 is the fourth function key 
KeyF4 KeyName = "F4" 

// KeyF5 is the fifth function key 
KeyF5 KeyName = "F5" 

// KeyF6 is the sixth function key 
KeyF6 KeyName = "F6" 

// KeyF7 is the seventh function key 
KeyF7 KeyName = "F7" 

// KeyF8 is the eighth function key 
KeyF8 KeyName = "F8" 

// KeyF9 is the ninth function key 
KeyF9 KeyName = "F9" 

// KeyF10 is the tenth function key 
KeyF10 KeyName = "F10" 

// KeyF1l1 is the eleventh function key 
KeyF1ll KeyName = "F11" 

// KeyF12 is the twelfth function key 
KeyF12 KeyName = "F12" 


// KeyEnter is the enter/ return key (keypad) 
KeyEnter KeyName = "KP_Enter" 


// KeyO represents the key 0 
KeyO KeyName = "0" 
// Keyl represents the key 1 
Keyl KeyName = "1" 
// Key2 represents the key 2 
Key2 KeyName = "2" 
// Key3 represents the key 3 
Key3 KeyName = "3" 
// Key4 represents the key 4 
Key4 KeyName = "4" 
// Key5 represents the key 5 
Key5 KeyName = "5" 
// Key6 represents the key 6 
Key6 KeyName = "6" 
// Key7 represents the key 7 
Key7 KeyName = "7" 
// Key8 represents the key 8 
Key8 KeyName = "8" 
// Key9 represents the key 9 
Key9 KeyName = "9" 
// KeyA represents the key A 
KeyA KeyName = "A" 
// KeyB represents the key B 
KeyB KeyName = "B" 
// KeyC represents the key C 
KeyC KeyName = "C" 
// KeyD represents the key D 
KeyD KeyName = "D" 
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tH 


y 


(full stop) 


// KeyE represents the key 
KeyE KeyName = "EK" 

// KeyF represents the key 
KeyF KeyName = "F" 

// KeyG represents the key 
KeyG KeyName = "G" 

// KeyH represents the key 
KeyH KeyName = "H" 

// KeyI represents the key 
KeyI KeyName = "I" 

// Keyd represents the key 
KeyJ KeyName = "J" 

// KeyK represents the key 
KeyK KeyName = "K" 

// KeyL represents the key 
KeyL KeyName = "L" 

// KeyM represents the key 
KeyM KeyName = "M" 

// KeyN represents the key 
KeyN KeyName = "N" 

// KeyO represents the key 
KeyO KeyName = "0" 

// KeyP represents the key 
KeyP KeyName = "P" 

// KeyQ represents the key 
KeyQ KeyName = "Q" 

// KeyR represents the key 
KeyR KeyName = "R" 

// KeyS represents the key 
KeyS KeyName = "S" 

// KeyT represents the key 
KeyT KeyName = "T" 

// KeyU represents the key 
KeyU KeyName = "U" 

// KeyV represents the key 
KeyV KeyName = "Vv" 

// KeyW represents the key 
KeyW KeyName = "W" 

// KeyX represents the key 
KeyX KeyName = "X" 

// KeyY represents the key 
KeyY KeyName = "Y" 

// KeyZ represents the key 
KeyZ KeyName = "Z" 

// KeySpace is the space k 
KeySpace KeyName = "Space" 
// KeyApostrophe is the key "’" 
KeyApostrophe KeyName = "/" 
// KeyComma is the key "," 
KeyComma KeyName = "," 

// KeyMinus is the key "-" 
KeyMinus KeyName = "-" 

// KeyPeriod is the key "." 
KeyPeriod KeyName wet 

// KeySlash is the key "/" 
KeySlash KeyName = "/" 
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// KeyBackslash is the key "\" 
KeyBackslash KeyName = "\\" 

// KeyLeftBracket is the key "[" 
KeyLeftBracket KeyName = "[" 

// KeyRightBracket is the key "]" 
KeyRightBracket KeyName = "]" 

// KeySemicolon is the key ";" 
KeySemicolon KeyName = ";" 

// KeyEqual is the key "=" 

KeyEqual KeyName = "=" 

// KeyAsterisk is the keypad key "*" 


KeyAsterisk KeyName = "*" 

// KeyPlus is the keypad key "+" 

KeyPlus KeyName = "+" 

// KeyBackTick is the key "*" on a US keyboard 
KeyBackTick KeyName = "‘" 


) 


Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 
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Fyne API "'fyne.Layout"' 


fyne.Layout 


import "fyne.io/fyne" 


Usage 


type Layout 


type Layout interface { 


} 


// Layout will manipulate the listed CanvasObjects Size and Position 
// to fit within the specified size. 

Layout ([]CanvasObject, Size) 

// MinSize calculates the smallest size that will fit the listed 

// CanvasObjects using this Layout algorithm. 

MinSize(objects []CanvasObject) Size 


Layout defines how CanvasObjects may be laid out in a specified Size. 
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Fyne API "fyne.ListableURI" 


fyne.ListableURI 


import "fyne.io/fyne" 


Usage 
type ListableURI 


type ListableURI interface { 
URI 


// List returns a list of child URIs of this URI. 
List() ([]URI, error) 
} 


ListableURI represents a URI that can have child items, most commonly a directory on disk in the native 
filesystem. 
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fyne.MainMenu 


import "fyne.io/fyne" 


Usage 


type MainMenu 


type MainMenu struct { 
Items []*Menu 


} 


MainMenu defines the data required to show a menu bar (desktop) or other appropriate top level menu. 


func NewMainMenu 


func NewMainMenu(items ...*Menu) *MainMenu 


NewMainMenu creates a top level menu structure used by fyne. Window for displaying a menubar (or 
appropriate equivalent). 
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import "fyne.io/fyne" 


Usage 


type Menu 


type Menu struct { 
Label string 
Items []*MenuItem 


} 


Menu stores the information required for a standard menu. A menu can pop down from a MainMenu or 
could be a pop out menu. 


func NewMenu 


func NewMenu(label string, items ...*MenuItem) *Menu 


NewMent creates a new menu given the specified label (to show in a MainMenu) and list of items to 
display. 
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fyne.Menultem 


import "fyne.io/fyne" 


Usage 


type Menultem 


type MenulItem struct { 
ChildMenu *Menu 
IsSeparator bool 
Label string 
Action func () 


} 


Menultem is a single item within any menu, it contains a display Label and Action function that is called 
when tapped. 


func NewMenultem 


func NewMenulItem(label string, action func()) *MenuItem 


NewMenultem creates a new menu item from the passed label and action parameters. 


func NewMenulItemSeparator 


func NewMenultemSeparator() *MenuItem 
NewMenultemSeparator creates a menu item that is to be used as a separator. 
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fyne.Notification 


import "fyne.io/fyne" 


Usage 


type Notification 


type Notification struct { 
Title, Content string 
} 


Notification represents a user notification that can be sent to the operating system. 


func NewNotification 


func NewNotification(title, content string) *Notification 
NewNotification creates a notification that can be passed to App.SendNotification. 
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fyne.OverlayStack 


import "fyne.io/fyne" 


Usage 


type OverlayStack 


type OverlayStack interface { 
// Add adds an overlay on the top of the overlay stack. 
Add(overlay CanvasObject) 
// List returns the overlays currently on the overlay stack. 
List() []CanvasObject 
// Remove removes the given object and all objects above it from the overlay stack. 
Remove (overlay CanvasObject) 
// Top returns the top-most object of the overlay stack. 
Top() CanvasObject 
} 


OverlayStack is a stack of CanvasObjects intended to be used as overlays of a Canvas. 
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fyne.PointEvent 


import "fyne.io/fyne" 


Usage 


type PointEvent 


type PointEvent struct { 
AbsolutePosition Position // The absolute position of the event 
Position Position // The relative position of the event 


} 


PointEvent describes a pointer input event. The position is relative to the top-left of the CanvasObject this 
is triggered on. 
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Fyne API "fyne.Position' 


fyne.Position 


import "fyne.io/fyne" 


Usage 


type Position 


type Position struct { 
X int // The position from the parent’s left edg 
Y int // The position from the parent’s top edge 


} 


Position describes a generic X, Y coordinate relative to a parent Canvas or CanvasObject. 


func NewPos 

func NewPos(x int, y int) Position 

NewPos returns a newly allocated Position representing the specified coordinates. 

func (Position) Add 

func (p Position) Add(p2 Position) Position 

Add returns a new Position that is the result of offsetting the current position by p2 X and Y. 
func (Position) IsZero 

func (p Position) IsZero() bool 


IsZero returns whether the Position is at the zero-point. 
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func (Position) Subtract 


func (p Position) Subtract (p2 Position) Position 
Subtract returns a new Position that is the result of offsetting the current position by p2 -X and -Y. 
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Fyne API "fyne.Preferences' 


fyne. 


Preferences 


import 


"fyne.io/fyne" 


Usage 


type Preferences 


type Preferences interface { 


// Bool looks up a boolean value for the key 

Bool(key string) bool 

// BoolWithFallback looks up a boolean value and returns the given fallback if not found 
BoolWithFallback (key string, fallback bool) bool 

// SetBool saves a boolean value for the given key 

SetBool (key string, value bool) 


// Float looks up a float64 value for the key 

Float (key string) float64 

// FloatWithFallback looks up a float64 value and returns the given fallback if not found 
FloatWithFallback(key string, fallback float64) float64 

// SetFloat saves a float64 value for the given key 

SetFloat (key string, value floaté64) 


// Int looks up an integer value for the key 

Int (key string) int 

// IntWithFallback looks up an integer value and returns the given fallback if not found 
IntWithFallback (key string, fallback int) int 

// SetInt saves an integer value for the given key 

SetInt (key string, value int) 


// String looks up a string value for the key 

String(key string) string 

// StringWithFallback looks up a string value and returns the given fallback if not found 
StringWithFallback(key, fallback string) string 

// SetString saves a string value for the given key 

SetString(key string, value string) 


// RemoveValue removes a value for the given key (not currently supported on iOS) 
RemoveValue (key string) 
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Fyne API "fyne.Resource"' 


fyne.Resource 


import "fyne.io/fyne" 


Usage 


type Resource 


type Resource interface { 
Name() string 
Content () []byte 


} 


Resource represents a single binary resource, such as an image or font. A resource has an identifying name 
and byte array content. The serialised path of a resource can be obtained which may result in a blocking 
filesystem write operation. 


func LoadResourceFromPath 


func LoadResourceFromPath(path string) (Resource, error) 


LoadResourceFromPath creates a new StaticResource in memory using the contents of the specified file. 


func LoadResourceFromURLString 


func LoadResourceFromURLString(urlStr string) (Resource, error) 


LoadResourceFromURLString creates a new StaticResource in memory using the body of the specified 
URL. 
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fyne.ScrollEvent 


import "fyne.io/fyne" 


Usage 


type ScrollEvent 


type ScrollEvent struct { 
PointEvent 
DeltaxX, DeltaY int 


} 


ScrollEvent defines the parameters of a pointer or other scroll event. The DeltaX and DeltaY represent 
how large the scroll was in two dimensions. 
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fyne.Scrollable 


import "fyne.io/fyne" 


Usage 
type Scrollable 


type Scrollable interface { 
Scrolled(*ScrollEvent) 


} 


Scrollable describes any CanvasObject that can also be scrolled. This is mostly used to implement the 
widget.ScrollContainer. 
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fyne.SecondaryTappable 


import "fyne.io/fyne" 


Usage 
type SecondaryTappable 


type SecondaryTappable interface { 
TappedSecondary (*PointEvent) 


} 
SecondaryTappable describes a CanvasObject that can be right-clicked or long-tapped. 
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fyne.Settings 


import "fyne.io/fyne" 


Usage 


type Settings 

type Settings interface { 
Theme () Theme 
Set Theme (Theme) 
Scale() float32 
PrimaryColor() string 


AddChangeListener(chan Settings) 
BuildType() BuildType 
} 


Settings describes the application configuration available. 
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fyne.Shortcut 


import "fyne.io/fyne" 


Usage 


type Shortcut 


type Shortcut interface { 
ShortcutName() string 


} 
Shortcut is the interface used to describe a shortcut action 
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fyne.ShortcutCopy 


import "fyne.io/fyne" 


Usage 


type ShortcutCopy 


type ShortcutCopy struct { 
Clipboard Clipboard 
} 


ShortcutCopy describes a shortcut copy action. 


func (*ShortcutCopy) ShortcutName 


func (se *ShortcutCopy) ShortcutName() string 
ShortcutName returns the shortcut name 
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fyne.ShortcutCut 


import "fyne.io/fyne" 


Usage 


type ShortcutCut 


type ShortcutCut struct { 
Clipboard Clipboard 
} 


ShortcutCut describes a shortcut cut action. 


func (*ShortcutCut) ShortcutName 


func (se *ShortcutCut) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.ShortcutHandler"' 


fyne.ShortcutHandler 


import "fyne.io/fyne" 


Usage 


type ShortcutHandler 


type ShortcutHandler struct { 
} 


ShortcutHandler is a default implementation of the shortcut handler for the canvasObject 


func (*ShortcutHandler) AddShortcut 


func (sh *ShortcutHandler) AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
AddShortcut register an handler to be executed when the shortcut action is triggered 

func (*ShortcutHandler) RemoveShortcut 

func (sh *ShortcutHandler) RemoveShortcut (shortcut Shortcut) 

RemoveShortcut removes a registered shortcut 

func (*ShortcutHandler) TypedShortcut 

func (sh *ShortcutHandler) TypedShortcut (shortcut Shortcut) 

TypedShortcut handle the registered shortcut 
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Fyne API "fyne.ShortcutPaste"' 


fyne.ShortcutPaste 


import "fyne.io/fyne" 


Usage 


type ShortcutPaste 


type ShortcutPaste struct { 
Clipboard Clipboard 
} 


ShortcutPaste describes a shortcut paste action. 


func (*ShortcutPaste) ShortcutName 


func (se *ShortcutPaste) ShortcutName() string 
ShortcutName returns the shortcut name 
Tags: 
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Fyne API "'fyne.ShortcutSelectAll"' 


fyne.ShortcutSelectAll 


import "fyne.io/fyne" 


Usage 
type ShortcutSelectAll 
type ShortcutSelectAll struct{} 


ShortcutSelectAll describes a shortcut selectAll action. 


func (*ShortcutSelectAll) ShortcutName 


func (se *ShortcutSelectAll) ShortcutName() string 
ShortcutName returns the shortcut name 
Tags: 
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Fyne API "fyne.Shortcutable"' 


fyne.Shortcutable 


import "fyne.io/fyne" 


Usage 


type Shortcutable 


type Shortcutable interface { 
TypedShortcut (Shortcut) 
} 


Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and 
paste). 


Tags: 
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Fyne API "fyne.Size" 


fyne.Size 


import "fyne.io/fyne" 


Usage 


type Size 


type Size struct { 
Width int // The number of units along the X axis. 
Height int // The number of units along the Y axis. 


} 


Size describes something with width and height. 


func MeasureText 


func MeasureText (text string, size int, style TextStyle) Siz 


MeasureText uses the current driver to calculate the size of text when rendered. 


func NewSize 

func NewSize(w int, h int) Size 

NewSize returns a newly allocated Size of the specified dimensions. 
func (Size) Add 

func (s Size) Add(s2 Size) Size 


Add returns a new Size that is the result of increasing the current size by s2 Width and Height. 
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func (Size) IsZero 


func (s Size) IsZero() bool 

IsZero returns whether the Size has zero width and zero height. 

func (Size) Max 

func (s Size) Max(s2 Size) Size 

Max returns a new Size that is the maximum of the current Size and s2. 
func (Size) Min 

func (s Size) Min(s2 Size) Size 

Min returns a new Size that is the minimum of the current Size and s2. 
func (Size) Subtract 

func (s Size) Subtract(s2 Size) Size 

Subtract returns a new Size that is the result of decreasing the current size by s2 Width and Height. 
func (Size) Union 

func (s Size) Union(s2 Size) Size 

Union returns a new Size that is the maximum of the current Size and s2. 


Deprecated: use Max() instead 
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Fyne API "fyne.StaticResource"' 


fyne.StaticResource 


import "fyne.io/fyne" 


Usage 


type StaticResource 


type StaticResource struct { 
StaticName string 
StaticContent []byte 
} 


StaticResource is a bundled resource compiled into the application. These resources are normally 
generated by the fyne_bundle command included in the Fyne toolkit. 


func NewStaticResource 
func NewStaticResource(name string, content []byte) *StaticResource 


NewStaticResource returns a new static resource object with the specified name and content. Creating a 
new Static resource in memory results in sharable binary data that may be serialised to the location 
returned by CachePath(). 

func (*StaticResource) Content 


func (r *StaticResource) Content() []byte 


Content returns the bytes of the bundled resource, no compression is applied but any compression on the 
resource is retained. 


func (*StaticResource) GoString 


func (r *StaticResource) GoString() string 


GoString converts a Resource object to Go code. This is useful if serialising to a Go file for compilation 
into a binary. 
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func (*StaticResource) Name 


func (r *StaticResource) Name() string 
Name returns the unique name of this resource, usually matching the file it was generated from. 
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Fyne API "'fyne.Storage" 


fyne.Storage 


import "fyne.io/fyne" 


Usage 


type Storage 


type Storage interface { 
RootURI() URI 
} 


Storage is used to manage file storage inside an application sandbox 
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fyne.String Validator 


import "fyne.io/fyne" 


Usage 

type StringValidator 

type StringValidator func(string) error 

String Validator is a function signature for validating string inputs. 
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fyne.Tappable 


import "fyne.io/fyne" 


Usage 
type Tappable 


type Tappable interface { 
Tapped (*PointEvent) 


} 


Tappable describes any CanvasObject that can also be tapped. This should be implemented by buttons etc 
that wish to handle pointer interactions. 
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Fyne API "fyne.TextAlign" 


fyne.TextAlign 


import "fyne.io/fyne" 


Usage 
type TextAlign 


type TextAlign int 


TextAlign represents the horizontal alignment of text within a widget or canvas object. 


const ( 
// TextAlignLeading specifies a left alignment for left-to-right languages. 
TextAlignLeading TextAlign = iota 
// TextAlignCenter places the text centrally within the available space. 
TextAlignCenter 
// TextAlignTrailing will align the text right for a left-to-right language. 
TextAlignTrailing 

) 
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fyne.TextStyle 


import "fyne.io/fyne" 


Usage 


type TextStyle 

type TextStyle struct { 
Bold bool // Should text be bold 
Italic bool // Should text be italic 


Monospace bool // Use the system monospace font instead of regular 


} 
TextStyle represents the styles that can be applied to a text canvas object or text based widget. 
Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


1682 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1683 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1684 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


1685 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


1686 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


1687 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


1688 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


1689 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


1690 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My Appl[p 5023] 
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fyne.TextWrap 


import "fyne.io/fyne" 


Usage 
type TextWrap 


type TextWrap int 


TextWrap represents how text longer than the widgetas width will be wrapped. 


const ( 
// TextWrapOff extends the widget’s width to fit the text, no wrapping is applied. 
TextWrapOff TextWrap = iota 
// TextTruncate trims the text to the widget’s width, no wrapping is applied. 
TextTruncate 
// TextWrapBreak trims the line of characters to the widget’s width adding the excess as new line. 
TextWrapBreak 
// TextWrapWord trims the line of words to the widget’s width adding the excess as new line. 
TextWrapWord 

) 
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fyne. Theme 


import "fyne.io/fyne" 


Usage 


type Theme 

type Theme interface { 
BackgroundColor() color.Color 
ButtonColor() color.Color 
DisabledButtonColor() color.Color 


// Deprecated: Hyperlinks now use the primary color for consistency. 
HyperlinkColor() color.Color 

TextColor() color.Color 

DisabledTextColor() color.Color 

// Deprecated: Icons now use the text colour for consistency. 
IconColor() color.Color 

// Deprecated: Disabled icons match disabled text color for consistency. 
DisabledIconColor() color.Color 

PlaceHolderColor() color.Color 

PrimaryColor() color.Color 

HoverColor() color.Color 

FocusColor() color.Color 

ScrollBarColor() color.Color 

ShadowColor() color.Color 


TextSize() int 

TextFont() Resource 
TextBoldFont() Resource 
TextItalicFont() Resource 
TextBoldItalicFont() Resource 
TextMonospaceFont () Resource 


Padding() int 


IconInlineSize() int 
ScrollBarSize() int 
ScrollBarSmallSize() int 


1700 


Theme defines the requirements of any Fyne theme. 
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Fyne API "fyne.URI" 


fyne.URI 


import "fyne.io/fyne" 


Usage 
type URI 


type URI interface { 

fmt .Stringer 
Extension() string 
Name() string 
MimeType() string 
Scheme() string 


} 


URI represents the identifier of a resource on a target system. This resource may be a file or another data 
source such as an app or file sharing system. 
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fyne. URIReadCloser 


import "fyne.io/fyne" 


Usage 
type URIReadCloser 


type URIReadCloser interface { 
io.ReadCloser 
// Deprecated, use URI().Name() instead 
Name() string 
URI() URI 


} 


URIReadCloser represents a cross platform data stream from a file or provider of data. It may refer to an 
item on a filesystem or data in another application that we have access to. 
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fyne.URIWriteCloser 


import "fyne.io/fyne" 


Usage 
type URIWriteCloser 


type URIWriteCloser interface { 
io.WriteCloser 
// Deprecated, use URI().Name() instead 
Name() string 
URI () URI 


} 


URIWriteCloser represents a cross platform data writer for a file resource. This will normally refer to a 
local file resource. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 


1728 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1729 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p ??] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1730 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


1731 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


1732 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


1733 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


1734 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


1735 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


1736 


© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API "fyne.Validatable"' 


fyne. Validatable 


import "fyne.io/fyne" 


Usage 
type Validatable 


type Validatable interface { 
Validate() error 


// SetOnValidationChanged is used to set the callback that will be triggered when the validation state changes. 
// The function might be overwritten by a parent that cares about child validation (e.g. widget.Form). 
SetOnValidationChanged (func (error) ) 

} 


Validatable is an interface for specifying if a widget is validatable. 


Since: 1.4 
Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


1737 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1738 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1739 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


1740 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

® 


[Line] [p 3387] 
[p 3397] 


1741 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


1742 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


1743 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


1744 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


1745 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
e [TreeNodeID][p 5014] 
@ [List My App][p 5023] 
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fyne. Widget 


import "fyne.io/fyne" 


Usage 
type Widget 


type Widget interface { 
CanvasObject 


// CreateRenderer returns a new WidgetRenderer for this widget. 
// This should not be called by regular code, it is used internally to render a widget. 


CreateRenderer() WidgetRenderer 


} 


Widget defines the standard behaviours of any widget. This extends the CanvasObject - a widget behaves 
in the same basic way but will encapsulate many child objects to create the rendered widget. 
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Fyne API "fyne.WidgetRenderer"' 


fyne.WidgetRenderer 


import "fyne.io/fyne" 


Usage 
type WidgetRenderer 


type WidgetRenderer interface { 
// BackgroundColor returns the color that should be used to draw the background of this renderer’s widget. 
// 
// Deprecated: Widgets will no longer have a background to support hover and selection indication in collection widgets. 
// Tf a widget requires a background color or image, this can be achieved by using a canvas.Rect or canvas.Image 
// as the first child of a MaxLayout, followed by the rest of the widget components. 


BackgroundColor() color.Color 
// Destroy is for internal use. 
Destroy () 


// Layout is a hook that is called if the widget needs to be laid out. 

// This should never call Refresh. 

Layout (Size) 

// MinSize returns the minimum size of the widget that is rendered by this renderer. 


MinSize() Size 
// Objects returns all objects that should be drawn. 
Objects() []CanvasObject 


// Refresh is a hook that is called if the widget has updated and needs to be redrawn. 
// This might trigger a Layout. 
Refresh () 


WidgetRenderer defines the behaviour of a widgetas implementation. This is returned from a widgetas 
declarative object through the CreateRenderer() function and should be exactly one instance per widget in 
memory. 
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Fyne API "fyne.Window"' 


fyne.Window 


import "fyne.io/fyne" 


Usage 
type Window 


type Window interface { 
// Title returns the current window title. 
// This is typically displayed in the window decorations. 
Title() string 
// SetTitle updates the current title of the window. 
SetTitle (string) 


// FullScreen returns whether or not this window is currently full screen. 
FullScreen() bool 

// SetFullScreen changes the requested fullScreen property 

// true for a fullScreen window and false to unset this. 

SetFullScreen (bool) 


// Resize this window to the requested content siz 

// The result may not be exactly as desired due to various desktop or 
// platform constraints. 

Resize (Size) 


// RequestFocus attempts to raise and focus this window. 

// This should only be called when you are sure the user would want this window 
// to steal focus from any current focused window. 

RequestFocus () 


// FixedSize returns whether or not this window should disable resizing. 
FixedSize() bool 

// SetFixedSize sets a hint that states whether the window should be a fixed 
// size or allow resizing. 

SetFixedSize (bool) 


// CenterOnScreen places a window at the center of the monitor 
// the Window object is currently positioned on. 
CenterOnScreen () 
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// Padded, normally true, states whether the window should have inner 

// padding so that components do not touch the window edge. 

Padded() bool 

// SetPadded allows applications to specify that a window should have 

// no inner padding. Useful for fullscreen or graphic based applications. 
SetPadded (bool) 


// Tcon returns the window icon, this is used in various ways 

// depending on operating system. 

// Most commonly this is displayed on the window border or task switcher. 
Icon() Resource 


// SetIcon sets the icon resource used for this window. 
// Tf none is set should return the application icon. 
SetIcon (Resource) 


// SetMaster indicates that closing this window should exit the app 
SetMaster () 


// MainMenu gets the content of the window’s top level menu. 
MainMenu() *MainMenu 


// SetMainMenu adds a top level menu to this window. 
// The way this is rendered will depend on the loaded driver. 
SetMainMenu (*MainMenu) 


// SetOnClosed sets a function that runs when the window is closed. 
SetOnClosed (func () ) 


// SetCloseIntercept sets a function that runs instead of closing if defined. 
// Close() should be called explicitly in the interceptor to close the window. 
// 

// Since: 1.4 

SetCloseIntercept (func () ) 


// Show the window on screen. 

Show () 

// Hide the window from the user. 

// This will not destroy the window or cause the app to exit. 

Hide () 

// Close the window. 

// If it is the only open window, or the "master" window the app will Quit. 
Close () 


// ShowAndRun is a shortcut to show the window and then run the application. 
// This should be called near th nd of a main() function as it will block. 
ShowAndRun () 


// Content returns the content of this window. 

Content () CanvasObject 

// SetContent sets the content of this window. 

SetContent (CanvasObject) 

// Canvas returns the canvas context to render in the window. 

// This can be useful to set a key handler for the window, for example. 
Canvas() Canvas 
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// Clipboard returns the system clipboard 
Clipboard() Clipboard 


Window describes a user interface window. Depending on the platform an app may have many windows 


or just the one. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Package fyne describes the objects and components available to any Fyne app. These can all be created, 
manipulated and tested without rendering (for speed). Your main package should use the app package to 
create an application with a default driver that will render your UI. 


A simple application may look like this: 
package main 


import "fyne.io/fyne/app" 
import "fyne.io/fyne/widget" 


func main() { 
a := app.New() 


w := a.NewWindow ("Hello") 
w.SetContent (widget .NewVBox ( 
widget .NewLabel ("Hello Fyne!"), 
widget .NewButton("Quit", func() { 
a.Quit () 


}))) 


w.ShowAndRun () 


Usage 


const SettingsScaleAuto = float32(-1.0) 


SettingsScaleAuto is a specific scale value that indicates a canvas should scale according to the DPI of the 
window that contains it. 


Deprecated: Automatic scaling is now handled in the drivers and is not a user setting. 
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func IsHorizontal 


func IsHorizontal (orient DeviceOrientation) bool 


IsHorizontal is a helper utility that determines if a passed orientation is horizontal 


func IsVertical 


func IsVertical(orient DeviceOrientation) bool 


IsVertical is a helper utility that determines if a passed orientation is vertical 


func LogError 


func LogError(reason string, err error) 


LogError reports an error to the command line with the specified err cause, if not nil. The function also 
reports basic information about the code location. 
func Max 


func Max(x, y int) int 


Max returns the larger of the passed values. 


func Min 


func Min(x, y int) int 
Min returns the smaller of the passed values. 


func SetCurrentApp 


func SetCurrentApp (current App) 


SetCurrentApp is an internal function to set the app instance currently running. 
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[Edit me] 


fyne 


import "fyne.io/fyne" 


Usage 


type App 


type App interface { 
// Create a new window for the application. 
// The first window to open is considered the "master" and when closed 
// the application will exit. 
NewWindow(title string) Window 


// Open a URL in the default browser application. 
OpenURL (url *url.URL) error 


// Icon returns the application icon, this is used in various ways 
// depending on operating system. 

// This is also the default icon for new windows. 

Icon() Resource 


// SetIcon sets the icon resource used for this application instance. 
SetIcon (Resource) 


// Run the application - this starts the event loop and waits until Quit () 
// is called or the last window closes. 

// This should be called near the end of a main() function as it will block. 
Run () 


// Calling Quit on the application will cause the application to exit 

// cleanly, closing all open windows. 

// This function does no thing on a mobile device as the application lifecycle is 
// managed by the operating system. 

Quit () 


// Driver returns the driver that is rendering this application. 
// Typically not needed for day to day work, mostly internal functionality. 
Driver() Driver 


// UniqueID returns the application unique identifier, if set. 
// This must be set for use of the Preferences() functions... see NewWithId(string) 


UniqueID() string 


// SendNotification sends a system notification that will be displayed in the operating system’s notification area. 
SendNotification (*Notification) 


// Settings return the globally set settings, determining theme and so on. 
Settings() Settings 


// Preferences returns the application preferences, used for storing configuration and state 
Preferences() Preferences 
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An App is the definition of a graphical application. Apps can have multiple windows, it will exit when the 
first window to be shown is closed. You can also cause the app to exit by calling Quit(). To start an 
application you need to call Run() somewhere in your main() function. Alternatively use the 
window.ShowAndRun() function for your main window. 


func CurrentApp 


func CurrentApp() App 
CurrentApp returns the current application, for which there is only 1 per process. 
Tags: 
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import "fyne.io/fyne" 


Usage 


type Canvas 


type Canvas interface { 
Content () CanvasObject 
SetContent (CanvasObject) 
Refresh (CanvasObject) 
Focus (Focusable) 
Unfocus () 
Focused() Focusable 


// Size returns the current size of this canvas 

Size() Size 

// Scale returns the current scale (multiplication factor) this canvas uses to render 

// The pixel size of a CanvasObject can be found by multiplying by this value. 

Scale() float32 

// SetScale sets ths scale for this canvas only, overriding system and user settings. 

hf 

// Deprecated: Settings are now calculated solely on the user configuration and system setup. 
SetScale (float32) 


// Overlay returns the current overlay. 

Th 

// Deprecated: Overlays are stacked now. 

// This method returns the top of the overlay stack. 
// Use Overlays() instead. 

Overlay() CanvasObject 

// Overlays returns the overlay stack. 

Overlays() OverlayStack 

// SetOverlay sets the overlay for the canvas. 

// 

// Deprecated: Overlays are stacked now. 

// This method replaces the whole stack by the given overlay. 
// Use Overlays() instead. 

SetOverlay (CanvasObject) 


OnTypedRune() func (rune) 

SetOnTypedRune (func (rune) ) 

OnTypedKey() func (*KeyEvent) 

SetOnTypedKey (func (*KeyEvent) ) 

AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 


Capture() image.Image 
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// PixelCoordinateForPosition returns the x and y pixel coordinate for a given position on this canvas. 
// This can be used to find absolute pixel positions or pixel offsets relative to an object top left. 
PixelCoordinateForPosition(Position) (int, int) 


Canvas defines a graphical canvas to which a CanvasObject or Container can be added. Each canvas has a 
scale which is automatically applied during the render process. 


Tags: 


If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 


1797 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1798 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p ??] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1799 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


1800 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


1801 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


1802 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


1803 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


1804 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


1805 


© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API fyne 
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import "fyne.io/fyne" 


Usage 


type CanvasObject 


type CanvasObject interface { 
// geometry 
Size() Size 
Resize (Size) 
Position() Position 
Move (Position) 
MinSize() Size 


// visibility 

Visible() bool 

// Show shows this object. 
Show () 

// Hide hides this object. 
Hide () 


Refresh () 
} 


CanvasObject describes any graphical object that can be added to a canvas. Objects have a size and 
position that can be controlled through this API. MinSize is used to determine the minimum size which 
this object should be displayed. An object will be visible by default but can be hidden with Hide() and 
re-shown with Show(). 


Note: If this object is controlled as part of a Layout you should not call Resize(Size) or Move(Position). 
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fyne 


import "fyne.io/fyne" 


Usage 
type Clipboard 


type Clipboard interface { 
// Content returns the clipboard content 
Content () string 
// SetContent sets the clipboard content 
SetContent (content string) 


} 
Clipboard represents the system clipboard interface 
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fyne 


import "fyne.io/fyne" 


Usage 


type Container 


type Container struct { 
Hidden bool // Is this Container hidden 


Layout Layout // The Layout algorithm for arranging child CanvasObjects 
Objects []CanvasObject // The set of CanvasObjects this container holds 


} 


Container is a CanvasObject that contains a collection of child objects. The layout of the children is set by 
the specified Layout. 


func NewContainer 

func NewContainer(objects ...CanvasObject) *Container 

NewContainer returns a new Container instance holding the specified CanvasObjects. 
func NewContainerWithLayout 


func NewContainerWithLayout (layout Layout, objects ...CanvasObject) *Container 


NewContainerWithLayout returns a new Container instance holding the specified CanvasObjects which 
will be laid out according to the specified Layout. 


func (*Container) AddObject 


func (c *Container) AddObject (o CanvasObject) 


AddObject adds another CanvasObject to the set this Container holds. 
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func (*Container) Hide 


func (c *Container) Hide () 

Hide sets this container, and all its children, to be not visible. 
func (*Container) MinSize 

func (c *Container) MinSize() Size 


MinSize calculates the minimum size of a Container. This is delegated to the Layout, if specified, 
otherwise it will mimic MaxLayout. 


func (*Container) Move 

func (c *Container) Move(pos Position) 

Move the container (and all its children) to a new position, relative to its parent. 
func (*Container) Position 

func (c *Container) Position() Position 

Position gets the current position of this Container, relative to its parent. 

func (*Container) Refresh 

func (c *Container) Refresh () 

Refresh causes this object to be redrawn in itas current state 


func (*Container) Resize 


func (c *Container) Resize(size Size) 


Resize sets a new size for the Container. 


func (*Container) Show 
func (c *Container) Show() 
Show sets this container, and all its children, to be visible. 


func (*Container) Size 


func (c *Container) Size() Siz 


Size returns the current size of this container. 
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func (*Container) Visible 


func (c *Container) Visible() bool 
Visible returns true if the container is currently visible, false otherwise. 
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import "fyne.io/fyne" 


Usage 


type Device 

type Device interface { 
Orientation() DeviceOrientation 
IsMobile() bool 
HasKeyboard() bool 
SystemScaleForWindow (Window) float32 


// Deprecated: Use SystemScaleForWindow instead - system scale can vary depending on window placement 
SystemScale() float32 


Device provides information about the devices the code is running on 


func CurrentDevice 


func CurrentDevice() Devic 


CurrentDevice returns the device information for the current hardware (via the driver) 
Tags: 
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import "fyne.io/fyne" 


Usage 


type DeviceOrientation 


type DeviceOrientation int 


DeviceOrientation represents the different ways that a mobile device can be held 


const ( 


Tags: 


// OrientationVertical is the default vertical orientation 

OrientationVertical DeviceOrientation = iota 

// OrientationVerticalUpsideDown is the portrait orientation held upside down 
OrientationVerticalUpsideDown 

// OrientationHorizontalLeft is used to indicate a landscape orientation with the top to the left 
OrientationHorizontalLeft 

// OrientationHorizontalRight is used to indicate a landscape orientation with the top to the right 
OrientationHorizontalRight 
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import "fyne.io/fyne" 


Usage 


type Disableable 

type Disableable interface { 
Enable () 
Disable () 
Disabled() bool 


} 


Disableable describes any CanvasObject that can be disabled. This is primarily used with objects that also 
implement the Tappable interface. 
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import "fyne.io/fyne" 


Usage 
type DoubleTappable 


type DoubleTappable interface { 
DoubleTapped (*PointEvent) 


} 
DoubleTappable describes any CanvasObject that can also be double tapped. 
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import "fyne.io/fyne" 


Usage 


type DragEvent 


type DragEvent struct { 
PointEvent 
DraggedX, DraggedY int 


} 


DragEvent defines the parameters of a pointer or other drag event. The DraggedX and DraggedY fields 
show how far the item was dragged since the last event. 
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import "fyne.io/fyne" 


Usage 
type Draggable 


type Draggable interface { 
Dragged (*DragEvent) 
DragEnd () 


} 


Draggable indicates that a CanvasObject can be dragged. This is used for any item that the user has 
indicated should be moved across the screen. 
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import "fyne.io/fyne" 


Usage 


type Driver 


type Driver interface { 
// CreateWindow creates a new UI Window. 
CreateWindow(string) Window 
// AllWindows returns a slice containing all app windows. 
AllWindows() []Window 


// RenderedTextSize returns the size required to render the given string of specified 
// font size and style. 
RenderedTextSize(string, int, TextStyle) Size 


// FileReaderForURI opens a file reader for the given resource indicator. 
// This may refer to a filesystem (typical on desktop) or data from another application. 
FileReaderForURI (URI) (URIReadCloser, error 


// FileWriterForURI opens a file writer for the given resource indicator. 
// This should refer to a filesystem resource as external data will not be writable. 
FileWriterForURI (URI) (URIWriteCloser, error) 


// CanvasForObject returns the canvas that is associated with a given CanvasObject. 

CanvasForObject (CanvasObject) Canvas 

// AbsolutePositionForObject returns the position of a given CanvasObject relative to the top/left of a canvas. 
AbsolutePositionForObject (CanvasObject) Position 


// Device returns the device that the application is currently running on. 


Device() Device 

// Run starts the main event loop of the driver. 

Run () 

// Quit closes the driver and open windows, then exit the application. 
Quit () 


Driver defines an abstract concept of a Fyne render driver. Any implementation must provide at least these 
methods. 
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import "fyne.io/fyne" 


Usage 


type Focusable 


type Focusable interface { 
FocusGained () 
FocusLost () 
Focused() bool // Deprecated: this is an internal detail, canvas tracks current focused object 


TypedRune (rune) 
TypedKey (*KeyEvent) 
} 


Focusable describes any CanvasObject that can respond to being focused. It will receive the FocusGained 
and FocusLost events appropriately. When focused it will also have TypedRune called as text is input and 
TypedKey called when other keys are pressed. 
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type KeyEvent 


type KeyEvent struct { 
Name KeyName 


} 
KeyEvent describes a keyboard input event. 
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fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
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0 [p 2656] 
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© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 
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[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 
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© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 
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[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 
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© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 
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[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 
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© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type KeyName 


type KeyName string 


KeyName represents the name of a key that has been pressed 


return (main keyboard) 


before-cursor key 


after-cursor key 


const ( 
// KeyEscape is the "esc" key 
KeyEscape KeyName = "Escape" 
// KeyReturn is the carriage 
KeyReturn KeyName = "Return" 
// KeyTab is the tab advance key 
KeyTab KeyName = "Tab" 
// KeyBackspace is the delet 
KeyBackspace KeyName = "BackSpace" 
// KeyInsert is the insert mode key 
KeyInsert KeyName = "Insert" 
// KeyDelete is the delet 
KeyDelete KeyName = "Delet 
// KeyRight is the right arrow key 
KeyRight KeyName = "Right" 


// KeyLeft is the left arrow key 


KeyLeft KeyName = "Left" 


// KeyDown is the down arrow 


KeyDown KeyName = "Down" 


// KeyUp is the up arrow key 


KeyUp KeyName = "Up" 


key 


// KeyPageUp is the page up num-pad key 


KeyPageUp KeyName = "Prior" 


// KeyPageDown is the page down num-pad key 


KeyPageDown KeyName = "Next" 


// KeyHome is the line-hom 


KeyHome KeyName = "Home" 


// KeyEnd is the line-end key 


KeyEnd KeyName = "End" 


key 
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// KeyFl is the first function key 
KeyFl KeyName = "F1" 

// KeyF2 is the second function key 
KeyF2 KeyName = "F2" 

// KeyF3 is the third function key 
KeyF3 KeyName = "F3" 

// KeyF4 is the fourth function key 
KeyF4 KeyName = "F4" 

// KeyF5 is the fifth function key 
KeyF5 KeyName = "F5" 

// KeyF6 is the sixth function key 
KeyF6 KeyName = "F6" 

// KeyF7 is the seventh function key 
KeyF7 KeyName = "F7" 

// KeyF8 is the eighth function key 
KeyF8 KeyName = "F8" 

// KeyF9 is the ninth function key 
KeyF9 KeyName = "F9" 

// KeyF10 is the tenth function key 
KeyF10 KeyName = "F10" 

// KeyF1l1 is the eleventh function key 
KeyF1ll KeyName = "F11" 

// KeyF12 is the twelfth function key 
KeyF12 KeyName = "F12" 


// KeyEnter is the enter/ return key (keypad) 
KeyEnter KeyName = "KP_Enter" 


// KeyO represents the key 0 
KeyO KeyName = "0" 
// Keyl represents the key 1 
Keyl KeyName = "1" 
// Key2 represents the key 2 
Key2 KeyName = "2" 
// Key3 represents the key 3 
Key3 KeyName = "3" 
// Key4 represents the key 4 
Key4 KeyName = "4" 
// Key5 represents the key 5 
Key5 KeyName = "5" 
// Key6 represents the key 6 
Key6 KeyName = "6" 
// Key7 represents the key 7 
Key7 KeyName = "7" 
// Key8 represents the key 8 
Key8 KeyName = "8" 
// Key9 represents the key 9 
Key9 KeyName = "9" 
// KeyA represents the key A 
KeyA KeyName = "A" 
// KeyB represents the key B 
KeyB KeyName = "B" 
// KeyC represents the key C 
KeyC KeyName = "C" 
// KeyD represents the key D 
KeyD KeyName = "D" 
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tH 


y 


(full stop) 


// KeyE represents the key 
KeyE KeyName = "EK" 

// KeyF represents the key 
KeyF KeyName = "F" 

// KeyG represents the key 
KeyG KeyName = "G" 

// KeyH represents the key 
KeyH KeyName = "H" 

// KeyI represents the key 
KeyI KeyName = "I" 

// Keyd represents the key 
KeyJ KeyName = "J" 

// KeyK represents the key 
KeyK KeyName = "K" 

// KeyL represents the key 
KeyL KeyName = "L" 

// KeyM represents the key 
KeyM KeyName = "M" 

// KeyN represents the key 
KeyN KeyName = "N" 

// KeyO represents the key 
KeyO KeyName = "0" 

// KeyP represents the key 
KeyP KeyName = "P" 

// KeyQ represents the key 
KeyQ KeyName = "Q" 

// KeyR represents the key 
KeyR KeyName = "R" 

// KeyS represents the key 
KeyS KeyName = "S" 

// KeyT represents the key 
KeyT KeyName = "T" 

// KeyU represents the key 
KeyU KeyName = "U" 

// KeyV represents the key 
KeyV KeyName = "Vv" 

// KeyW represents the key 
KeyW KeyName = "W" 

// KeyX represents the key 
KeyX KeyName = "X" 

// KeyY represents the key 
KeyY KeyName = "Y" 

// KeyZ represents the key 
KeyZ KeyName = "Z" 

// KeySpace is the space k 
KeySpace KeyName = "Space" 
// KeyApostrophe is the key "’" 
KeyApostrophe KeyName = "/" 
// KeyComma is the key "," 
KeyComma KeyName = "," 

// KeyMinus is the key "-" 
KeyMinus KeyName = "-" 

// KeyPeriod is the key "." 
KeyPeriod KeyName wet 

// KeySlash is the key "/" 
KeySlash KeyName = "/" 
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// KeyBackslash is the key "\" 
KeyBackslash KeyName = "\\" 

// KeyLeftBracket is the key "[" 
KeyLeftBracket KeyName = "[" 

// KeyRightBracket is the key "]" 
KeyRightBracket KeyName = "]" 

// KeySemicolon is the key ";" 
KeySemicolon KeyName = ",;" 
// KeyEqual is the key "= 
KeyEqual KeyName = "=" 

// KeyBackTick is the key "*‘" on a US keyboard 
KeyBackTick KeyName = "*‘" 


) 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 
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Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 
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© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 
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[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 
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© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 
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[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 
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© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 
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[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
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import "fyne.io/fyne" 


Usage 


type Layout 


type Layout interface { 


} 


// Layout will manipulate the listed CanvasObjects Size and Position 
// to fit within the specified siz 

Layout ([]CanvasObject, Size) 

// MinSize calculates the smallest size that will fit the listed 

// CanvasObjects using this Layout algorithm. 

MinSize(objects []CanvasObject) Size 


Layout defines how CanvasObjects may be laid out in a specified Size. 
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import "fyne.io/fyne" 


Usage 


type MainMenu 


type MainMenu struct { 
Items []*Menu 


} 


MainMenu defines the data required to show a menu bar (desktop) or other appropriate top level menu. 


func NewMainMenu 


func NewMainMenu(items ...*Menu) *MainMenu 


NewMainMenu creates a top level menu structure used by fyne. Window for displaying a menubar (or 
appropriate equivalent). 
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import "fyne.io/fyne" 


Usage 


type Menu 


type Menu struct { 
Label string 
Items []*MenuItem 


} 


Menu stores the information required for a standard menu. A menu can pop down from a MainMenu or 
could be a pop out menu. 


func NewMenu 


func NewMenu(label string, items ...*MenuItem) *Menu 


NewMent creates a new menu given the specified label (to show in a MainMenu) and list of items to 
display. 
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import "fyne.io/fyne" 


Usage 


type Menultem 


type MenulItem struct { 
ChildMenu *Menu 
IsSeparator bool 
Label string 
Action func () 


} 


Menultem is a single item within any menu, it contains a display Label and Action function that is called 
when tapped. 


func NewMenultem 


func NewMenulItem(label string, action func()) *MenuItem 


NewMenultem creates a new menu item from the passed label and action parameters. 


func NewMenultemSeparator 


func NewMenultemSeparator() *MenuItem 
NewMenultemSeparator creates a menu item that is to be used as a separator. 
Tags: 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 


1955 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


1956 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


1957 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


1958 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


1959 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


1960 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


1961 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


1962 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


1963 


© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type Notification 


type Notification struct { 
Title, Content string 
} 


Notification represents a user notification that can be sent to the operating system. 


func NewNotification 


func NewNotification(title, content string) *Notification 
NewNotification creates a notification that can be passed to App.SendNotification. 
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Usage 


type OverlayStack 


type OverlayStack interface { 
// Add adds an overlay on the top of the overlay stack. 
Add(overlay CanvasObject) 
// List returns the overlays currently on the overlay stack. 
List() []CanvasObject 
// Remove removes the given object and all objects above it from the overlay stack. 
Remove (overlay CanvasObject) 
// Top returns the top-most object of the overlay stack. 
Top() CanvasObject 


OverlayStack is a stack of CanvasObjects intended to be used as overlays of a Canvas. 
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import "fyne.io/fyne" 


Usage 


type PointEvent 


type PointEvent struct { 
AbsolutePosition Position // The absolute position of the event 
Position Position // The relative position of the event 


} 


PointEvent describes a pointer input event. The position is relative to the top-left of the CanvasObject this 
is triggered on. 
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import "fyne.io/fyne" 


Usage 


type Position 


type Position struct { 
X int // The position from the parent’s left edg 
Y int // The position from the parent’s top edge 


} 


Position describes a generic X, Y coordinate relative to a parent Canvas or CanvasObject. 


func NewPos 

func NewPos(x int, y int) Position 

NewPos returns a newly allocated Position representing the specified coordinates. 

func (Position) Add 

func (p Position) Add(p2 Position) Position 

Add returns a new Position that is the result of offsetting the current position by p2 X and Y. 
func (Position) IsZero 

func (p Position) IsZero() bool 


IsZero returns whether the Position is at the zero-point. 
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func (Position) Subtract 


func (p Position) Subtract (p2 Position) Position 
Subtract returns a new Position that is the result of offsetting the current position by p2 -X and -Y. 
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import "fyne.io/fyne" 


Usage 


type Preferences 


type Preferences interface { 
// Bool looks up a boolean value for the key 
Bool(key string) bool 
// BoolWithFallback looks up a boolean value and returns the given fallback if not found 
BoolWithFallback (key string, fallback bool) bool 
// SetBool saves a boolean value for the given key 
SetBool (key string, value bool) 


// Float looks up a float64 value for the key 

Float (key string) float64 

// FloatWithFallback looks up a float64 value and returns the given fallback if not found 
FloatWithFallback(key string, fallback float64) float64 

// SetFloat saves a float64 value for the given key 

SetFloat (key string, value floaté64) 


// Int looks up an integer value for the key 

Int (key string) int 

// IntWithFallback looks up an integer value and returns the given fallback if not found 
IntWithFallback (key string, fallback int) int 

// SetInt saves an integer value for the given key 

SetInt (key string, value int) 


// String looks up a string value for the key 

String(key string) string 

// StringWithFallback looks up a string value and returns the given fallback if not found 
StringWithFallback(key, fallback string) string 

// SetString saves a string value for the given key 

SetString(key string, value string) 


// RemoveValue removes a value for the given key (not currently supported on iOS) 
RemoveValue (key string) 


2001 


Preferences describes the ways that an app can save and load user preferences 
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import "fyne.io/fyne" 


Usage 


type Resource 


type Resource interface { 
Name() string 
Content () []byte 
} 


Resource represents a single binary resource, such as an image or font. A resource has an identifying name 
and byte array content. The serialised path of a resource can be obtained which may result in a blocking 
filesystem write operation. 


func LoadResourceFromPath 


func LoadResourceFromPath(path string) (Resource, error) 


LoadResourceFromPath creates a new StaticResource in memory using the contents of the specified file. 


func LoadResourceFromURLString 


func LoadResourceFromURLString(urlStr string) (Resource, error) 


LoadResourceFromURLString creates a new StaticResource in memory using the body of the specified 
URL. 
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import "fyne.io/fyne" 


Usage 


type ScrollEvent 


type ScrollEvent struct { 
PointEvent 
DeltaxX, DeltaY int 


} 


ScrollEvent defines the parameters of a pointer or other scroll event. The DeltaX and DeltaY represent 
how large the scroll was in two dimensions. 
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import "fyne.io/fyne" 


Usage 
type Scrollable 


type Scrollable interface { 
Scrolled(*ScrollEvent) 


} 


Scrollable describes any CanvasObject that can also be scrolled. This is mostly used to implement the 
widget.ScrollContainer. 
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type SecondaryTappable 


type SecondaryTappable interface { 
TappedSecondary (*PointEvent) 


} 
SecondaryTappable describes a CanvasObject that can be right-clicked or long-tapped. 
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type Settings 


type Settings interface { 
Theme () Theme 
Set Theme (Theme) 
Scale() float32 


AddChangeListener(chan Settings) 
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Settings describes the application configuration available. 
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type ShortcutCopy struct { 
Clipboard Clipboard 
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ShortcutCopy describes a shortcut copy action. 


func (*ShortcutCopy) ShortcutName 


func (se *ShortcutCopy) ShortcutName() string 
ShortcutName returns the shortcut name 
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import "fyne.io/fyne" 
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type ShortcutCut 


type ShortcutCut struct { 
Clipboard Clipboard 
} 


ShortcutCut describes a shortcut cut action. 


func (*ShortcutCut) ShortcutName 


func (se *ShortcutCut) ShortcutName() string 
ShortcutName returns the shortcut name 
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import "fyne.io/fyne" 


Usage 


type ShortcutHandler 


type ShortcutHandler struct { 
} 


ShortcutHandler is a default implementation of the shortcut handler for the canvasObject 


func (*ShortcutHandler) AddShortcut 


func (sh *ShortcutHandler) AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 


AddShortcut register an handler to be executed when the shortcut action is triggered 


func (*ShortcutHandler) TypedShortcut 


func (sh *ShortcutHandler) TypedShortcut (shortcut Shortcut) 
TypedShortcut handle the registered shortcut 
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import "fyne.io/fyne" 
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type ShortcutPaste 


type ShortcutPaste struct { 
Clipboard Clipboard 
} 


ShortcutPaste describes a shortcut paste action. 


func (*ShortcutPaste) ShortcutName 


func (se *ShortcutPaste) ShortcutName() string 
ShortcutName returns the shortcut name 
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import "fyne.io/fyne" 


Usage 
type ShortcutSelectAll 
type ShortcutSelectAll struct{} 


ShortcutSelectAll describes a shortcut selectAll action. 


func (*ShortcutSelectAll) ShortcutName 


func (se *ShortcutSelectAll) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type Shortcutable 


type Shortcutable interface { 
TypedShortcut (Shortcut) 
} 


Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and 
paste). 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type Size 


type Size struct { 
Width int // The number of units along the X axis. 
Height int // The number of units along the Y axis. 


} 


Size describes something with width and height. 


func MeasureText 


func MeasureText (text string, size int, style TextStyle) Siz 


MeasureText uses the current driver to calculate the size of text when rendered. 


func NewSize 

func NewSize(w int, h int) Size 

NewSize returns a newly allocated Size of the specified dimensions. 
func (Size) Add 

func (s Size) Add(s2 Size) Size 


Add returns a new Size that is the result of increasing the current size by s2 Width and Height. 
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func (Size) IsZero 


func (s Size) IsZero() bool 

IsZero returns whether the Size has zero width and zero height. 

func (Size) Max 

func (s Size) Max(s2 Size) Size 

Max returns a new Size that is the maximum of the current Size and s2. 
func (Size) Min 

func (s Size) Min(s2 Size) Size 

Min returns a new Size that is the minimum of the current Size and s2. 
func (Size) Subtract 

func (s Size) Subtract(s2 Size) Size 

Subtract returns a new Size that is the result of decreasing the current size by s2 Width and Height. 
func (Size) Union 

func (s Size) Union(s2 Size) Size 

Union returns a new Size that is the maximum of the current Size and s2. 


Deprecated: use Max() instead 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type StaticResource 


type StaticResource struct { 
StaticName string 
StaticContent []byte 
} 


StaticResource is a bundled resource compiled into the application. These resources are normally 
generated by the fyne_bundle command included in the Fyne toolkit. 


func NewStaticResource 
func NewStaticResource(name string, content []byte) *StaticResource 


NewStaticResource returns a new static resource object with the specified name and content. Creating a 
new Static resource in memory results in sharable binary data that may be serialised to the location 
returned by CachePath(). 

func (*StaticResource) Content 


func (r *StaticResource) Content() []byte 


Content returns the bytes of the bundled resource, no compression is applied but any compression on the 
resource is retained. 


func (*StaticResource) GoString 


func (r *StaticResource) GoString() string 


GoString converts a Resource object to Go code. This is useful if serialising to a Go file for compilation 
into a binary. 
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func (*StaticResource) Name 


func (r *StaticResource) Name() string 
Name returns the unique name of this resource, usually matching the file it was generated from. 
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import "fyne.io/fyne" 
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type Tappable 


type Tappable interface { 
Tapped (*PointEvent) 
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Tappable describes any CanvasObject that can also be tapped. This should be implemented by buttons etc 
that wish to handle pointer interactions. 
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import "fyne.io/fyne" 


Usage 
type TextAlign 


type TextAlign int 


TextAlign represents the horizontal alignment of text within a widget or canvas object. 


const ( 
// TextAlignLeading specifies a left alignment for left-to-right languages. 
TextAlignLeading TextAlign = iota 
// TextAlignCenter places the text centrally within the available space. 
TextAlignCenter 
// TextAlignTrailing will align the text right for a left-to-right language. 
TextAlignTrailing 

) 
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import "fyne.io/fyne" 


Usage 


type TextStyle 

type TextStyle struct { 
Bold bool // Should text be bold 
Italic bool // Should text be italic 


Monospace bool // Use the system monospace font instead of regular 


} 
TextStyle represents the styles that can be applied to a text canvas object or text based widget. 
Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


2157 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


2158 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


2159 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


2160 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

® 


[Line] [p 3387] 
[p 3397] 


2161 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


2162 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


2163 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


2164 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


2165 


© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 
type TextWrap 


type TextWrap int 


TextWrap represents how text longer than the widgetas width will be wrapped. 


const ( 
// TextWrapOff extends the widget’s width to fit the text, no wrapping is applied. 
TextWrapOff TextWrap = iota 
// TextTruncate trims the text to the widget’s width, no wrapping is applied. 
TextTruncate 
// TextWrapBreak trims the line of characters to the widget’s width adding the excess as new line. 
TextWrapBreak 
// TextWrapWord trims the line of words to the widget’s width adding the excess as new line. 
TextWrapWord 

) 
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import "fyne.io/fyne" 


Usage 


type Theme 

type Theme interface { 
BackgroundColor() color.Color 
ButtonColor() color.Color 


DisabledButtonColor() color.Color 
HyperlinkColor() color.Color 
TextColor() color.Color 
DisabledTextColor() color.Color 
IconColor() color.Color 
DisabledIconColor() color.Color 
PlaceHolderColor() color.Color 
PrimaryColor() color.Color 
HoverColor() color.Color 
FocusColor() color.Color 
ScrollBarColor() color.Color 
ShadowColor() color.Color 


TextSize() int 

TextFont() Resource 
TextBoldFont() Resource 
TextItalicFont() Resource 
TextBoldItalicFont() Resource 
TextMonospaceFont () Resource 


Padding() int 


IconInlineSize() int 
ScrollBarSize() int 
ScrollBarSmallSize() int 


Theme defines the requirements of any Fyne theme. 
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import "fyne.io/fyne" 


Usage 
type URI 


type URI interface { 
fmt .Stringer 


Extension() string 
MimeType() string 
Scheme() string 


} 


URI represents the identifier of a resource on a target system. This resource may be a file or another data 
source such as an app or file sharing system. 
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import "fyne.io/fyne" 


Usage 
type URIReadCloser 


type URIReadCloser interface { 
io.ReadCloser 
Name() string 
URI() URI 


} 


URIReadCloser represents a cross platform data stream from a file or provider of data. It may refer to an 
item on a filesystem or data in another application that we have access to. 
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import "fyne.io/fyne" 


Usage 
type URIWriteCloser 


type URIWriteCloser interface { 
io.WriteCloser 
Name() string 
URI() URI 

} 


URIWriteCloser represents a cross platform data writer for a file resource. This will normally refer to a 
local file resource. 
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import "fyne.io/fyne" 


Usage 
type Widget 


type Widget interface { 
CanvasObject 


CreateRenderer() WidgetRenderer 


} 


Widget defines the standard behaviours of any widget. This extends the CanvasObject - a widget behaves 
in the same basic way but will encapsulate many child objects to create the rendered widget. 
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import "fyne.io/fyne" 


Usage 
type WidgetRenderer 


type WidgetRenderer interface { 
Layout (Size) 


MinSize() Size 

Refresh () 

BackgroundColor() color.Color 
Objects() []CanvasObject 
Destroy () 


} 


WidgetRenderer defines the behaviour of a widgetas implementation. This is returned from a widgetas 
declarative object through the Render() function and should be exactly one instance per widget in 
memory. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 
type Window 


type Window interface { 
// Title returns the current window title. 
// This is typically displayed in the window decorations. 
Title() string 
// SetTitle updates the current title of the window. 
SetTitle (string) 


// FullScreen returns whether or not this window is currently full screen. 
FullScreen() bool 

// SetFullScreen changes the requested fullScreen property 

// true for a fullScreen window and false to unset this. 

SetFullScreen (bool) 


// Resize this window to the requested content siz 

// The result may not be exactly as desired due to various desktop or 
// platform constraints. 

Resize (Size) 


// RequestFocus attempts to raise and focus this window. 

// This should only be called when you are sure the user would want this window 
// to steal focus from any current focused window. 

RequestFocus () 


// FixedSize returns whether or not this window should disable resizing. 
FixedSize() bool 

// SetFixedSize sets a hint that states whether the window should be a fixed 
// size or allow resizing. 

SetFixedSize (bool) 


// CenterOnScreen places a window at the center of the monitor 
// the Window object is currently positioned on. 
CenterOnScreen () 
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// Padded, normally true, states whether the window should have inner 

// padding so that components do not touch the window edge. 

Padded() bool 

// SetPadded allows applications to specify that a window should have 

// no inner padding. Useful for fullscreen or graphic based applications. 
SetPadded (bool) 


// Tcon returns the window icon, this is used in various ways 

// depending on operating system. 

// Most commonly this is displayed on the window border or task switcher. 
Icon() Resource 


// SetIcon sets the icon resource used for this window. 
// Tf none is set should return the application icon. 
SetIcon (Resource) 


// SetMaster indicates that closing this window should exit the app 
SetMaster () 


// MainMenu gets the content of the window’s top level menu. 
MainMenu() *MainMenu 


// SetMainMenu adds a top level menu to this window. 
// The way this is rendered will depend on the loaded driver. 
SetMainMenu (*MainMenu) 


SetOnClosed(func() ) 


// Show the window on screen. 

Show () 

// Hide the window from the user. 

// This will not destroy the window or cause the app to exit. 

Hide () 

// Close the window. 

// If it is the only open window, or the "master" window the app will Quit. 
Close () 


// ShowAndRun is a shortcut to show the window and then run the application. 
// This should be called near th nd of a main() function as it will block. 
ShowAndRun () 


// Content returns the content of this window. 

Content () CanvasObject 

// SetContent sets the content of this window. 

SetContent (CanvasObject) 

// Canvas returns the canvas context to render in the window. 

// This can be useful to set a key handler for the window, for example. 
Canvas() Canvas 


// Clipboard returns the system clipboard 
Clipboard() Clipboard 


Window describes a user interface window. Depending on the platform an app may have many windows 
or just the one. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Package fyne describes the objects and components available to any Fyne app. These can all be created, 
manipulated and tested without rendering (for speed). Your main package should use the app package to 
create an application with a default driver that will render your UI. 


A simple application may look like this: 
package main 


import "fyne.io/fyne/app" 
import "fyne.io/fyne/widget" 


func main() { 
a := app.New() 


w := a.NewWindow ("Hello") 
w.SetContent (widget .NewVBox ( 
widget .NewLabel ("Hello Fyne!"), 
widget .NewButton("Quit", func() { 
a.Quit () 


}))) 


w.ShowAndRun () 


Usage 


const SettingsScaleAuto = float32(-1.0) 


SettingsScaleAuto is a specific scale value that indicates a canvas should scale according to the DPI of the 
window that contains it. 
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func IsHorizontal 


func IsHorizontal (orient DeviceOrientation) bool 


IsHorizontal is a helper utility that determines if a passed orientation is horizontal 


func IsVertical 


func IsVertical(orient DeviceOrientation) bool 


IsVertical is a helper utility that determines if a passed orientation is vertical 


func LogError 


func LogError(reason string, err error) 


LogError reports an error to the command line with the specified err cause, if not nil. The function also 
reports basic information about the code location. 
func Max 


func Max(x, y int) int 


Max returns the larger of the passed values. 


func Min 


func Min(x, y int) int 
Min returns the smaller of the passed values. 


func SetCurrentApp 


func SetCurrentApp (current App) 


SetCurrentApp is an internal function to set the app instance currently running. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type App 


type App interface { 
// Create a new window for the application. 
// The first window to open is considered the "master" and when closed 
// the application will exit. 
NewWindow(title string) Window 


// Open a URL in the default browser application. 
OpenURL (url *url.URL) error 


// Icon returns the application icon, this is used in various ways 
// depending on operating system. 

// This is also the default icon for new windows. 

Icon() Resource 


// SetIcon sets the icon resource used for this application instance. 
SetIcon (Resource) 


// Run the application - this starts the event loop and waits until Quit () 
// is called or the last window closes. 

// This should be called near the end of a main() function as it will block. 
Run () 


// Calling Quit on the application will cause the application to exit 
// cleanly, closing all open windows. 
Quit () 


// Driver returns the driver that is rendering this application. 
// Typically not needed for day to day work, mostly internal functionality. 
Driver() Driver 


// UniqueID returns the application unique identifier, if set. 
// This must be set for use of the Preferences() functions... see NewWithId(string) 


UniqueID() string 


// Settings return the globally set settings, determining theme and so on. 
Settings() Settings 


2252 


// Preferences returns the application preferences, used for storing configuration and state 
Preferences() Preferences 


} 


An App is the definition of a graphical application. Apps can have multiple windows, it will exit when the 
first window to be shown is closed. You can also cause the app to exit by calling Quit(). To start an 
application you need to call Run() somewhere in your main() function. Alternatively use the 
window.ShowAndRun() function for your main window. 


func CurrentApp 


func CurrentApp() App 


CurrentApp returns the current application, for which there is only 1 per process. 
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import "fyne.io/fyne" 


Usage 


type Canvas 


type Canvas interface { 


Content () CanvasObject 
SetContent (CanvasObject) 
Refresh (CanvasObject) 
Focus (Focusable) 
Unfocus () 

Focused() Focusable 


// Size returns the current size of this canvas 

Size() Size 

// Scale returns the current scale (multiplication factor) this canvas uses to render 

// The pixel size of a CanvasObject can be found by multiplying by this value. 

Scale() float32 

// SetScale sets ths scale for this canvas only, overriding system and user settings. 

hf 

// Deprecated: Settings are now calculated solely on the user configuration and system setup. 
SetScale (float32) 


Overlay() CanvasObject 
SetOverlay (CanvasObject) 


OnTypedRune() func (rune) 

SetOnTypedRune (func (rune) ) 

OnTypedKey() func (*KeyEvent) 

SetOnTypedKey (func (*KeyEvent) ) 

AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 


Capture() image.Image 
// PixelCoordinateForPosition returns the x and y pixel coordinate for a given position on this 


// This can be used to find absolute pixel positions or pixel offsets relative to an object top 
PixelCoordinateForPosition(Position) (int, int) 


canvas. 
left. 


Canvas defines a graphical canvas to which a CanvasObject or Container can be added. Each canvas has a 
scale which is automatically applied during the render process. 
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import "fyne.io/fyne" 


Usage 


type CanvasObject 


type CanvasObject interface { 
// geometry 
Size() Size 
Resize (Size) 
Position() Position 
Move (Position) 
MinSize() Size 


// visibility 
Visible() bool 
Show () 
Hide () 


Refresh () 
} 


CanvasObject describes any graphical object that can be added to a canvas. Objects have a size and 
position that can be controlled through this API. MinSize is used to determine the minimum size which 
this object should be displayed. An object will be visible by default but can be hidden with Hide() and 
re-shown with Show(). 


Note: If this object is controlled as part of a Layout you should not call Resize(Size) or Move(Position). 
Tags: 
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import "fyne.io/fyne" 


Usage 
type Clipboard 


type Clipboard interface { 
// Content returns the clipboard content 
Content () string 
// SetContent sets the clipboard content 
SetContent (content string) 


} 
Clipboard represents the system clipboard interface 
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import "fyne.io/fyne" 


Usage 


type Container 


type Container struct { 
Hidden bool // Is this Container hidden 


Layout Layout // The Layout algorithm for arranging child CanvasObjects 
Objects []CanvasObject // The set of CanvasObjects this container holds 


} 


Container is a CanvasObject that contains a collection of child objects. The layout of the children is set by 
the specified Layout. 


func NewContainer 

func NewContainer(objects ...CanvasObject) *Container 

NewContainer returns a new Container instance holding the specified CanvasObjects. 
func NewContainerWithLayout 


func NewContainerWithLayout (layout Layout, objects ...CanvasObject) *Container 


NewContainerWithLayout returns a new Container instance holding the specified CanvasObjects which 
will be laid out according to the specified Layout. 


func (*Container) AddObject 


func (c *Container) AddObject (o CanvasObject) 


AddObject adds another CanvasObject to the set this Container holds. 
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func (*Container) Hide 


func (c *Container) Hide () 

Hide sets this container, and all its children, to be not visible. 
func (*Container) MinSize 

func (c *Container) MinSize() Size 


MinSize calculates the minimum size of a Container. This is delegated to the Layout, if specified, 
otherwise it will mimic MaxLayout. 


func (*Container) Move 

func (c *Container) Move(pos Position) 

Move the container (and all its children) to a new position, relative to its parent. 
func (*Container) Position 

func (c *Container) Position() Position 

Position gets the current position of this Container, relative to its parent. 

func (*Container) Refresh 

func (c *Container) Refresh () 

Refresh causes this object to be redrawn in itas current state 


func (*Container) Resize 


func (c *Container) Resize(size Size) 


Resize sets a new size for the Container. 


func (*Container) Show 
func (c *Container) Show() 
Show sets this container, and all its children, to be visible. 


func (*Container) Size 


func (c *Container) Size() Siz 


Size returns the current size of this container. 
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func (*Container) Visible 


func (c *Container) Visible() bool 
Visible returns true if the container is currently visible, false otherwise. 
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import "fyne.io/fyne" 


Usage 


type Device 


type Device interface { 
Orientation() DeviceOrientation 
IsMobile() bool 
HasKeyboard() bool 
SystemScale() float32 


} 


Device provides information about the devices the code is running on 


func CurrentDevice 


func CurrentDevice() Devic 


CurrentDevice returns the device information for the current hardware (via the driver) 
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import "fyne.io/fyne" 


Usage 


type DeviceOrientation 


type DeviceOrientation int 


DeviceOrientation represents the different ways that a mobile device can be held 


const ( 


Tags: 


// OrientationVertical is the default vertical orientation 

OrientationVertical DeviceOrientation = iota 

// OrientationVerticalUpsideDown is the portrait orientation held upside down 
OrientationVerticalUpsideDown 

// OrientationHorizontalLeft is used to indicate a landscape orientation with the top to the left 
OrientationHorizontalLeft 

// OrientationHorizontalRight is used to indicate a landscape orientation with the top to the right 
OrientationHorizontalRight 
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import "fyne.io/fyne" 


Usage 


type Disableable 

type Disableable interface { 
Enable () 
Disable () 
Disabled() bool 


} 


Disableable describes any CanvasObject that can be disabled. This is primarily used with objects that also 
implement the Tappable interface. 
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type DoubleTappable 


type DoubleTappable interface { 
DoubleTapped (*PointEvent) 


} 
DoubleTappable describes any CanvasObject that can also be double tapped. 
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import "fyne.io/fyne" 


Usage 


type DragEvent 


type DragEvent struct { 
PointEvent 
DraggedX, DraggedY int 
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DragEvent defines the parameters of a pointer or other drag event. The DraggedX and DraggedY fields 
show how far the item was dragged since the last event. 
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fyne 


import "fyne.io/fyne" 


Usage 
type Draggable 


type Draggable interface { 
Dragged (*DragEvent) 
DragEnd () 


} 


Draggable indicates that a CanvasObject can be dragged. This is used for any item that the user has 
indicated should be moved across the screen. 
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import "fyne.io/fyne" 


Usage 


type Driver 


type Driver interface { 
// Create a new UI Window. 
CreateWindow(string) Window 
// Get a slice containing all app windows. 
AllWindows() []Window 


// Return the size required to render the given string of specified 
// font size and style. 
RenderedTextSize(string, int, TextStyle) Siz 


// Get the canvas that is associated with a given CanvasObject. 

CanvasForObject (CanvasObject) Canvas 

// Get the position of a given CanvasObject relative to the top/left of a canvas. 
AbsolutePositionForObject (CanvasObject) Position 


// Get the device that the application is currently running on 


Device() Device 

// Start the main event loop of the driver. 

Run () 

// Close the driver and open windows then exit the application. 
Quit () 


Driver defines an abstract concept of a Fyne render driver. Any implementation must provide at least these 
methods. 
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import "fyne.io/fyne" 


Usage 


type Focusable 


type Focusable interface { 
FocusGained () 
FocusLost () 
Focused() bool 


TypedRune (rune) 
TypedKey (*KeyEvent) 


} 


Focusable describes any CanvasObject that can respond to being focused. It will receive the FocusGained 
and FocusLost events appropriately. When focused it will also have TypedRune called as text is input and 
TypedKey called when other keys are pressed. 
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type KeyEvent 


type KeyEvent struct { 
Name KeyName 


} 
KeyEvent describes a keyboard input event. 
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[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
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© [ColorPickerDialog][p 3923] 
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© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type KeyName 


type KeyName string 


KeyName represents the name of a key that has been pressed 


return (main keyboard) 


before-cursor key 


after-cursor key 


const ( 
// KeyEscape is the "esc" key 
KeyEscape KeyName = "Escape" 
// KeyReturn is the carriage 
KeyReturn KeyName = "Return" 
// KeyTab is the tab advance key 
KeyTab KeyName = "Tab" 
// KeyBackspace is the delet 
KeyBackspace KeyName = "BackSpace" 
// KeyInsert is the insert mode key 
KeyInsert KeyName = "Insert" 
// KeyDelete is the delet 
KeyDelete KeyName = "Delet 
// KeyRight is the right arrow key 
KeyRight KeyName = "Right" 


// KeyLeft is the left arrow key 


KeyLeft KeyName = "Left" 


// KeyDown is the down arrow 


KeyDown KeyName = "Down" 


// KeyUp is the up arrow key 


KeyUp KeyName = "Up" 


key 


// KeyPageUp is the page up num-pad key 


KeyPageUp KeyName = "Prior" 


// KeyPageDown is the page down num-pad key 


KeyPageDown KeyName = "Next" 


// KeyHome is the line-hom 


KeyHome KeyName = "Home" 


// KeyEnd is the line-end key 


KeyEnd KeyName = "End" 


key 
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// KeyFl is the first function key 
KeyFl KeyName = "F1" 

// KeyF2 is the second function key 
KeyF2 KeyName = "F2" 

// KeyF3 is the third function key 
KeyF3 KeyName = "F3" 

// KeyF4 is the fourth function key 
KeyF4 KeyName = "F4" 

// KeyF5 is the fifth function key 
KeyF5 KeyName = "F5" 

// KeyF6 is the sixth function key 
KeyF6 KeyName = "F6" 

// KeyF7 is the seventh function key 
KeyF7 KeyName = "F7" 

// KeyF8 is the eighth function key 
KeyF8 KeyName = "F8" 

// KeyF9 is the ninth function key 
KeyF9 KeyName = "F9" 

// KeyF10 is the tenth function key 
KeyF10 KeyName = "F10" 

// KeyF1l1 is the eleventh function key 
KeyF1ll KeyName = "F11" 

// KeyF12 is the twelfth function key 
KeyF12 KeyName = "F12" 


// KeyEnter is the enter/ return key (keypad) 
KeyEnter KeyName = "KP_Enter" 


// KeyO represents the key 0 
KeyO KeyName = "0" 
// Keyl represents the key 1 
Keyl KeyName = "1" 
// Key2 represents the key 2 
Key2 KeyName = "2" 
// Key3 represents the key 3 
Key3 KeyName = "3" 
// Key4 represents the key 4 
Key4 KeyName = "4" 
// Key5 represents the key 5 
Key5 KeyName = "5" 
// Key6 represents the key 6 
Key6 KeyName = "6" 
// Key7 represents the key 7 
Key7 KeyName = "7" 
// Key8 represents the key 8 
Key8 KeyName = "8" 
// Key9 represents the key 9 
Key9 KeyName = "9" 
// KeyA represents the key A 
KeyA KeyName = "A" 
// KeyB represents the key B 
KeyB KeyName = "B" 
// KeyC represents the key C 
KeyC KeyName = "C" 
// KeyD represents the key D 
KeyD KeyName = "D" 
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tH 


y 


(full stop) 


// KeyE represents the key 
KeyE KeyName = "EK" 

// KeyF represents the key 
KeyF KeyName = "F" 

// KeyG represents the key 
KeyG KeyName = "G" 

// KeyH represents the key 
KeyH KeyName = "H" 

// KeyI represents the key 
KeyI KeyName = "I" 

// Keyd represents the key 
KeyJ KeyName = "J" 

// KeyK represents the key 
KeyK KeyName = "K" 

// KeyL represents the key 
KeyL KeyName = "L" 

// KeyM represents the key 
KeyM KeyName = "M" 

// KeyN represents the key 
KeyN KeyName = "N" 

// KeyO represents the key 
KeyO KeyName = "0" 

// KeyP represents the key 
KeyP KeyName = "P" 

// KeyQ represents the key 
KeyQ KeyName = "Q" 

// KeyR represents the key 
KeyR KeyName = "R" 

// KeyS represents the key 
KeyS KeyName = "S" 

// KeyT represents the key 
KeyT KeyName = "T" 

// KeyU represents the key 
KeyU KeyName = "U" 

// KeyV represents the key 
KeyV KeyName = "Vv" 

// KeyW represents the key 
KeyW KeyName = "W" 

// KeyX represents the key 
KeyX KeyName = "X" 

// KeyY represents the key 
KeyY KeyName = "Y" 

// KeyZ represents the key 
KeyZ KeyName = "Z" 

// KeySpace is the space k 
KeySpace KeyName = "Space" 
// KeyApostrophe is the key "’" 
KeyApostrophe KeyName = "/" 
// KeyComma is the key "," 
KeyComma KeyName = "," 

// KeyMinus is the key "-" 
KeyMinus KeyName = "-" 

// KeyPeriod is the key "." 
KeyPeriod KeyName wet 

// KeySlash is the key "/" 
KeySlash KeyName = "/" 
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// KeyBackslash is the key "\" 
KeyBackslash KeyName = "\\" 

// KeyLeftBracket is the key "[" 
KeyLeftBracket KeyName = "[" 

// KeyRightBracket is the key "]" 
KeyRightBracket KeyName = "]" 

// KeySemicolon is the key ";" 
KeySemicolon KeyName = ",;" 
// KeyEqual is the key "= 
KeyEqual KeyName = "=" 

// KeyBackTick is the key "*‘" on a US keyboard 
KeyBackTick KeyName = "*‘" 


) 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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© Layout and widget size 
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Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
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[MainMenu][p 2928} 
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[Settings][p 3039] 
[Shortcut] [p 3048] 
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[p 3066] 
[p 3076] 
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[URTReadCTosey|[p 3253] 
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e [SettingsSchema][p 3328] 
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© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 
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© [ConfirmDialog]{p 3933) 
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[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


2393 


® |ToolbarSpacer}[p 4993] 
@ [p 5002] 
@ |TreeNodeID|[p 5014] 


e (Listy Apalip 5023) 


Fyne API fyne 
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import "fyne.io/fyne" 


Usage 


type Layout 


type Layout interface { 


} 


// Layout will manipulate the listed CanvasObjects Size and Position 
// to fit within the specified siz 

Layout ([]CanvasObject, Size) 

// MinSize calculates the smallest size that will fit the listed 

// CanvasObjects using this Layout algorithm. 

MinSize(objects []CanvasObject) Size 


Layout defines how CanvasObjects may be laid out in a specified Size. 
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import "fyne.io/fyne" 


Usage 


type MainMenu 


type MainMenu struct { 
Items []*Menu 


} 


MainMenu defines the data required to show a menu bar (desktop) or other appropriate top level menu. 


func NewMainMenu 


func NewMainMenu(items ...*Menu) *MainMenu 


NewMainMenu creates a top level menu structure used by fyne. Window for displaying a menubar (or 
appropriate equivalent). 
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import "fyne.io/fyne" 


Usage 


type Menu 


type Menu struct { 
Label string 
Items []*MenuItem 


} 


Menu stores the information required for a standard menu. A menu can pop down from a MainMenu or 
could be a pop out menu. 


func NewMenu 


func NewMenu(label string, items ...*MenuItem) *Menu 


NewMent creates a new menu given the specified label (to show in a MainMenu) and list of items to 
display. 
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import "fyne.io/fyne" 


Usage 


type Menultem 


type MenulItem struct { 
Label string 
Action func() 


} 


Menultem is a sligne item within any menu, it contains a dispay Label and Action function that is called 


when tapped. 


func NewMenultem 


func NewMenulItem(label string, action func()) *MenuItem 


NewMenultem creates a new menu item from the passed label and action parameters. 
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import "fyne.io/fyne" 


Usage 


type PointEvent 


type PointEvent struct { 
AbsolutePosition Position // The absolute position of the event 
Position Position // The relative position of the event 


} 


PointEvent describes a pointer input event. The position is relative to the top-left of the CanvasObject this 
is triggered on. 
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import "fyne.io/fyne" 


Usage 


type Position 


type Position struct { 
X int // The position from the parent’s left edg 
Y int // The position from the parent’s top edge 


} 


Position describes a generic X, Y coordinate relative to a parent Canvas or CanvasObject. 


func NewPos 


func NewPos(x int, y int) Position 


NewPos returns a newly allocated Position representing the specified coordinates. 


func (Position) Add 


func (pl Position) Add(p2 Position) Position 


Add returns a new Position that is the result of offsetting the current position by p2 X and Y. 


func (Position) Subtract 


func (pl Position) Subtract(p2 Position) Position 
Subtract returns a new Position that is the result of offsetting the current position by p2 -X and -Y. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type Preferences 


type Preferences interface { 
// Bool looks up a boolean value for the key 
Bool(key string) bool 
// BoolWithFallback looks up a boolean value and returns the given fallback if not found 
BoolWithFallback (key string, fallback bool) bool 
// SetBool saves a boolean value for the given key 
SetBool (key string, value bool) 


// Float looks up a float64 value for the key 

Float (key string) float64 

// FloatWithFallback looks up a float64 value and returns the given fallback if not found 
FloatWithFallback(key string, fallback float64) float64 

// SetFloat saves a float64 value for the given key 

SetFloat (key string, value floaté64) 


// Int looks up an integer value for the key 

Int (key string) int 

// IntWithFallback looks up an integer value and returns the given fallback if not found 
IntWithFallback (key string, fallback int) int 

// SetInt saves an integer value for the given key 

SetInt (key string, value int) 


// String looks up a string value for the key 

String(key string) string 

// StringWithFallback looks up a string value and returns the given fallback if not found 
StringWithFallback(key, fallback string) string 

// SetString saves a string value for the given key 

SetString(key string, value string) 


// RemoveValue removes a value for the given key (not currently supported on iOS) 
RemoveValue (key string) 
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import "fyne.io/fyne" 


Usage 


type Resource 


type Resource interface { 
Name() string 
Content () []byte 
} 


Resource represents a single binary resource, such as an image or font. A resource has an identifying name 
and byte array content. The serialised path of a resource can be obtained which may result in a blocking 
filesystem write operation. 


func LoadResourceFromPath 


func LoadResourceFromPath(path string) (Resource, error) 


LoadResourceFromPath creates a new StaticResource in memory using the contents of the specified file. 


func LoadResourceFromURLString 


func LoadResourceFromURLString(urlStr string) (Resource, error) 


LoadResourceFromURLString creates a new StaticResource in memory using the body of the specified 
URL. 
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import "fyne.io/fyne" 


Usage 


type ScrollEvent 


type ScrollEvent struct { 
PointEvent 
DeltaxX, DeltaY int 


} 


ScrollEvent defines the parameters of a pointer or other scroll event. The DeltaX and DeltaY represent 
how large the scroll was in two dimensions. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 
type Scrollable 


type Scrollable interface { 
Scrolled(*ScrollEvent) 


} 


Scrollable describes any CanvasObject that can also be scrolled. This is mostly used to implement the 
widget.ScrollContainer. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 


2476 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


2477 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p ??] 


O00 0 


00000 0 


0O00000 0 


O00 0 


2478 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


2479 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


2480 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


2481 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


2482 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


2483 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


2484 


© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type Settings 


type Settings interface { 
Theme () Theme 
Set Theme (Theme) 
Scale() float32 


AddChangeListener(chan Settings) 
} 


Settings describes the application configuration available. 
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type ShortcutHandler 


type ShortcutHandler struct { 
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ShortcutHandler is a default implementation of the shortcut handler for the canvasObject 


func (*ShortcutHandler) AddShortcut 


func (sh *ShortcutHandler) AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 


AddShortcut register an handler to be executed when the shortcut action is triggered 


func (*ShortcutHandler) TypedShortcut 


func (sh *ShortcutHandler) TypedShortcut (shortcut Shortcut) 
TypedShortcut handle the registered shortcut 
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import "fyne.io/fyne" 


Usage 


type ShortcutPaste 


type ShortcutPaste struct { 
Clipboard Clipboard 
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ShortcutPaste describes a shortcut paste action. 


func (*ShortcutPaste) ShortcutName 


func (se *ShortcutPaste) ShortcutName() string 
ShortcutName returns the shortcut name 
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import "fyne.io/fyne" 


Usage 
type ShortcutSelectAll 
type ShortcutSelectAll struct{} 


ShortcutSelectAll describes a shortcut selectAll action. 


func (*ShortcutSelectAll) ShortcutName 


func (se *ShortcutSelectAll) ShortcutName() string 
ShortcutName returns the shortcut name 
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import "fyne.io/fyne" 


Usage 


type Shortcutable 


type Shortcutable interface { 
TypedShortcut (Shortcut) 
} 


Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and 
paste). 
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fyne 


import "fyne.io/fyne" 


Usage 


type Size 


type Size struct { 
Width int // The number of units along the X axis. 
Height int // The number of units along the Y axis. 


} 


Size describes something with width and height. 


func NewSize 


func NewSize(w int, h int) Size 


NewSize returns a newly allocated Size of the specified dimensions. 


func (Size) Add 


func (sl Size) Add(s2 Size) Size 


Add returns a new Size that is the result of increasing the current size by s2 Width and Height. 


func (Size) Subtract 


func (sl Size) Subtract(s2 Size) Size 


Subtract returns a new Size that is the result of decreasing the current size by s2 Width and Height. 
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func (Size) Union 


func (sl Size) Union(s2 Size) Size 
Union returns a new Size that is the maximum of the current Size and s2. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 


type StaticResource 


type StaticResource struct { 
StaticName string 
StaticContent []byte 
} 


StaticResource is a bundled resource compiled into the application. These resources are normally 
generated by the fyne_bundle command included in the Fyne toolkit. 


func NewStaticResource 
func NewStaticResource(name string, content []byte) *StaticResource 


NewStaticResource returns a new static resource object with the specified name and content. Creating a 
new Static resource in memory results in sharable binary data that may be serialised to the location 
returned by CachePath(). 

func (*StaticResource) Content 


func (r *StaticResource) Content() []byte 


Content returns the bytes of the bundled resource, no compression is applied but any compression on the 
resource is retained. 


func (*StaticResource) GoString 


func (r *StaticResource) GoString() string 


GoString converts a Resource object to Go code. This is useful if serialising to a Go file for compilation 
into a binary. 
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func (*StaticResource) Name 


func (r *StaticResource) Name() string 
Name returns the unique name of this resource, usually matching the file it was generated from. 
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import "fyne.io/fyne" 


Usage 
type Tappable 


type Tappable interface { 
Tapped (*PointEvent) 
TappedSecondary (*PointEvent) 


} 


Tappable describes any CanvasObject that can also be tapped. This should be implemented by buttons etc 
that wish to handle pointer interactions. 
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import "fyne.io/fyne" 


Usage 
type TextAlign 


type TextAlign int 


TextAlign represents the horizontal alignment of text within a widget or canvas object. 


const ( 
// TextAlignLeading specifies a left alignment for left-to-right languages. 
TextAlignLeading TextAlign = iota 
// TextAlignCenter places the text centrally within the available space. 
TextAlignCenter 
// TextAlignTrailing will align the text right for a left-to-right language. 
TextAlignTrailing 

) 
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import "fyne.io/fyne" 


Usage 


type TextStyle 

type TextStyle struct { 
Bold bool // Should text be bold 
Italic bool // Should text be italic 


Monospace bool // Use the system monospace font instead of regular 


} 
TextStyle represents the styles that can be applied to a text canvas object or text based widget. 
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type Theme 

type Theme interface { 
BackgroundColor() color.Color 
ButtonColor() color.Color 


DisabledButtonColor() color.Color 
HyperlinkColor() color.Color 
TextColor() color.Color 
DisabledTextColor() color.Color 
IconColor() color.Color 
DisabledIconColor() color.Color 
PlaceHolderColor() color.Color 
PrimaryColor() color.Color 
HoverColor() color.Color 
FocusColor() color.Color 
ScrollBarColor() color.Color 
ShadowColor() color.Color 


TextSize() int 

TextFont() Resource 
TextBoldFont() Resource 
TextItalicFont() Resource 
TextBoldItalicFont() Resource 
TextMonospaceFont () Resource 


Padding() int 


IconInlineSize() int 
ScrollBarSize() int 
ScrollBarSmallSize() int 


Theme defines the requirements of any Fyne theme. 
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import "fyne.io/fyne" 


Usage 
type Widget 


type Widget interface { 
CanvasObject 


CreateRenderer() WidgetRenderer 


} 


Widget defines the standard behaviours of any widget. This extends the CanvasObject - a widget behaves 
in the same basic way but will encapsulate many child objects to create the rendered widget. 
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import "fyne.io/fyne" 


Usage 
type WidgetRenderer 


type WidgetRenderer interface { 
Layout (Size) 


MinSize() Size 

Refresh () 

BackgroundColor() color.Color 
Objects() []CanvasObject 
Destroy () 


} 


WidgetRenderer defines the behaviour of a widgetas implementation. This is returned from a widgetas 
declarative object through the Render() function and should be exactly one instance per widget in 
memory. 
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Fyne API fyne 


fyne 


import "fyne.io/fyne" 


Usage 
type Window 


type Window interface { 
// Title returns the current window title. 
// This is typically displayed in the window decorations. 
Title() string 
// SetTitle updates the current title of the window. 
SetTitle (string) 


// FullScreen returns whether or not this window is currently full screen. 
FullScreen() bool 

// SetFullScreen changes the requested fullScreen property 

// true for a fullScreen window and false to unset this. 

SetFullScreen (bool) 


// Resize this window to the requested content siz 

// The result may not be exactly as desired due to various desktop or 
// platform constraints. 

Resize (Size) 


// RequestFocus attempts to raise and focus this window. 

// This should only be called when you are sure the user would want this window 
// to steal focus from any current focused window. 

RequestFocus () 


// FixedSize returns whether or not this window should disable resizing. 
FixedSize() bool 

// SetFixedSize sets a hint that states whether the window should be a fixed 
// size or allow resizing. 

SetFixedSize (bool) 


// CenterOnScreen places a window at the center of the monitor 
// the Window object is currently positioned on. 
CenterOnScreen () 
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// Padded, normally true, states whether the window should have inner 

// padding so that components do not touch the window edge. 

Padded() bool 

// SetPadded allows applications to specify that a window should have 

// no inner padding. Useful for fullscreen or graphic based applications. 
SetPadded (bool) 


// Tcon returns the window icon, this is used in various ways 

// depending on operating system. 

// Most commonly this is displayed on the window border or task switcher. 
Icon() Resource 


// SetIcon sets the icon resource used for this window. 
// Tf none is set should return the application icon. 
SetIcon (Resource) 


// SetMaster indicates that closing this window should exit the app 
SetMaster () 


// MainMenu gets the content of the window’s top level menu. 
MainMenu() *MainMenu 


// SetMainMenu adds a top level menu to this window. 
// The way this is rendered will depend on the loaded driver. 
SetMainMenu (*MainMenu) 


SetOnClosed(func() ) 


// Show the window on screen. 

Show () 

// Hide the window from the user. 

// This will not destroy the window or cause the app to exit. 

Hide () 

// Close the window. 

// If it is the only open window, or the "master" window the app will Quit. 
Close () 


// ShowAndRun is a shortcut to show the window and then run the application. 
// This should be called near th nd of a main() function as it will block. 
ShowAndRun () 


// Content returns the content of this window. 

Content () CanvasObject 

// SetContent sets the content of this window. 

SetContent (CanvasObject) 

// Canvas returns the canvas context to render in the window. 

// This can be useful to set a key handler for the window, for example. 
Canvas() Canvas 


//Clipboard returns the system clipboard 
Clipboard() Clipboard 


Window describes a user interface window. Depending on the platform an app may have many windows 
or just the one. 
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Getting Started 


Getting Started 


Using the Fyne toolkit to build cross platform applications is very simple but does require some tools to be 
installed before you can begin. If your computer is set up for development with Go then the following 
steps may not be required, but we advise reading the tips for your operating system just in case. If later 
steps in this tutorial fail then you should re-visit the prerequisites below. 


Prerequisites 


Fyne requires 3 basic elements to be present, the Go tools (at least version 1.12), a C compiler (to connect 
with system graphics drivers) and an system graphics driver. The instructions vary depending on your 
operating system, choose the appropriate tab below for installation instructions. 


Note that these steps are just required for development - your Fyne applications will not require any setup 
or dependency installation for end users! 


Windows 
macOS X 
Linux 
Raspberry Pi 
BSD 
Android 

iOS 


1. Download Go from the [p ??] and follow instructions 


N 


. Install one of the available C compilers for windows, the following are tested with Go and Fyne: 


© MSYS2 with MingW-w64 -[msys2.org][p ??] 
© TDM.GCC -ffdm-geerdragon.nel][p 77 
© Cygwin -[eygwin.com[p 72] 


. In Windows your graphics driver will already be installed, but it is recommended to ensure they are 


up to date. 


The steps for installing with MSYS2 (recommended) are as follows: 
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Install MSYS2 from|msys2.org][p ??] 


Once installed do not use the MSYS terminal that opens 
Open 4AMSYS2 MinGW 64-bita from the start menu 


Execute the following commands (if asked for install options be sure to choose 4alla): 


$ pacman -Syu 
$ pacman -S git mingw-w64-x86_64-toolchain 


You will need to add /c/Program\ Files/Go/bin and ~/Go/bin to your PATH, for MSYS2 you can 
paste the following command into your terminal: 


$ echo "export PATH=\SPATH:/c/Program\ Files/Go/bin:~/Go/bin" >> ~/.bashre 


. Download Go from the [p ??] and follow instructions 
. Install Xcode from the [p ??] 


. Set up the Xcode command line tools by opening a Terminal window and typing the following: 
xcode-select --install 
. In macOS the graphics drivers will already be installed. 


You will need to install Go, gcc and the graphics library header files using your package manager, 
one of the following commands will probably work. 

Debian / Ubuntu: sudo apt-get install golang gcc libgli-mesa-dev 
xorg-dev 

Fedora: sudo dnf install golang gcc libXcursor-devel libXrandr-devel 
mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm—-devel 
Arch Linux: sudo pacman -S go xorg-server-devel libxcursor libxrandr 
libxinerama libxi 


Solus: sudo eopkg it -c system.devel golang mesalib-devel 
libxrandr-devel libxcursor-devel libxi-devel libxinerama-devel 
openSUSE: sudo zypper install go gcc libXcursor-devel libXrandr-devel 
Mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm—devel 
Void Linux: sudo xbps-install -S go base-devel xorg-server-devel 
libXrandr-devel libXcursor-devel libXinerama-devel 

Alpine Linux sudo apk add go gcc libxcursor-dev libxrandr-dev 
libxinerama-dev libxi-dev linux-headers mesa-dev 


You will need to install Go, gcc and the graphics library header files using the package manager. 


sudo apt-get install golang gcc libegll-mesa-dev xorg-dev 


You will need to install Go, gcc and the graphics library header files using the package manager. 
FreeBSD: sudo pkg install go gcc xorg pkgconf 

OpenBSD: sudo pkg_add go 

NetBSD: sudo pkgin install go pkgconf 
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@ To develop apps for Android you will first need to install the tools for your current computer 
(Windows, macOS or Linux) 

@ Once complete you will need to install the Android SDK and Android NDK - the recommended 
approach is to install [Android Studio] [p ??] and then go to Tools > SDK Manager and from SDK 
Tools install the NDK (Side by side) package. 


@ To develop apps for iOS you will need access to an Apple Mac computer, configured according to 
the macOS tab above. 


@ You will also need to create an{Apple Developer account}[p ??] and sign up to the developer program 


(costs apply) to obtain the necessary certificate to run your app on any devices. 


Downloading 


When using Go modules (required with Go 1.16 and later), you will need to set up the module before you 
can use the package. If you are not using modules or you already have your module initialized, you can 
skip this to the next step. Run the following command and replace MODULE_NAME with your preferred 
module name (this should be called in a new folder specific for your application). 


$ cd myapp 
§ go mod init MODULE_NAME 


You now need to download the Fyne module. This will be done using the following command: 
§ go get fyne.io/fyne/v2 


To finish your moduledas set up, you now need to tidy the module file to correctly reference Fyne as a 
dependency. You do this by using the following command (can be skipped if you are not using modules): 


$ go mod tidy 


If you are unsure of how Go modules work, consider reading|Tutorial: Create a Go module}[p ??] . 


Run the demo 


If you want to see the Fyne toolkit in action before you start to code your own application, you can see our 
[p ??] running on your computer by executing: 


$ go run fyne.io/fyne/v2/cmd/fyne_demo 


Please note that the first run has to compile some C-code and can thus take longer than usual. Subsequent 
builds reuse the cache and will be much faster. 


Installing 


If you want to, you can also install the demo using the following command (requires Go 1.16 or later): 
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§ go install fyne.io/fyne/v2/cmd/fyne_demo@latest 
For earlier versions of Go, you need to use the following command instead: 
§ go get fyne.io/fyne/v2/cmd/fyne_demo 


If your GOBIN environment has been added to path (should be by default on macOS and Windows), you 
can then run the demo: 


S$ fyne_demo 


And thatas all there is to it! Now you can write your own Fyne application in your IDE of choice. If you 
want to see some Fyne code in action then you can read your first application. 


If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 
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Data Binding 


Data binding is a powerful new addition to the Fyne toolkit that was introduced in version v2.0.0. By 
using data binding we can avoid manually managing many standard objects like Labels, Buttons and 
Lists. 


The builtin bindings support many primitive types (like Int, String, Float etc), lists (such as 
StringList, BoolList) as well as Map and Struct bindings. Each of these types can be created 
using a simple constructor function. For example to create a new string binding with a zero value you can 
use binding.NewString(). You can get or set the value of most data bindings using Get and Set 
methods. 


It is also possible to bind to an existing value using similar functions whods names start Bind and they all 
accept a pointer to the type bound. To bind to an existing int we could use 

binding.BindInt (&myInt). By keeping a reference to a bound value instead of the original 
variable we can configure widgets and functions to respond to any changes automatically. If you change 
the external data directly, be sure to call Reload() to ensure that the binding system reads the new value. 


package main 


import ( 
"Log" 


"fyne.io/fyne/v2/data/binding" 
) 


func main() { 
boundString := binding.NewString() 
Ss, _ := boundString.Get () 
log.Printf("Bound = ’%s’", s) 


myInt := 5 
boundInt := binding.BindInt (&émyInt) 
i, _ := boundInt.Get () 


log.Printf("Source = Sd, bound = %d", myInt, i) 
} 


We start learning about simple values widget binding next. 
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Organisation and Packages 


The Fyne project is split into many packages, each providing different types of functionality. They are as 
follows: 


fyne.io/fyne/v2 

This import provides the basic definitions common to all Fyne code 

including data types and interfaces. 
fyne.io/fyne/v2/app 

The app package provides the APIs that start a new application. 

Normally you only require app.New() or app.NewWithID(). 
fyne.io/fyne/v2/canvas 

The canvas package provides all of the drawing APIs within Fyne. 

The complete Fyne toolkit is made up of these primitive graphical types. 
fyne.io/fyne/v2/container 

The container package provides containers that are used to lay out and organise applications. 
fyne.io/fyne/v2/data/binding 

The binding package contains ways of binding data sources to widgets. 
fyne.io/fyne/v2/data/validation 

The validation package provides tooling for validating data inside widgets. 
fyne.io/fyne/v2/dialog 

The dialog package contains dialogs such as confirm, error and file save/open. 
fyne.io/fyne/v2/layout 

The layout package provides various layout implementations for use 

with containers (discussed in a later tutorial). 
fyne.io/fyne/v2/storage 

The storage package provides storage access and management functionality. 
fyne.io/fyne/v2/test 

Applications can be tested more easily using the tools within the test 

package. 
fyne.io/fyne/v2/widget 

Most graphical applications are created using a collection of widgets. 

All the widgets and interactive elements within Fyne are in this package. 


If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 
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Upgrading to v2.2 


The 2.2 release is fully backward compatible with 2.0.4 and earlier, so upgrading is as simple as updating 
the version of code you compile with. This is different depending on whether or not you use go modules. 


Modules 


If your project has a go.mod file then you can edit the require line to use version v2.2.0, or you can 
execute the following command inside the directory: 


go get fyne.io/fyne/v2@v2.2.0 


The next time you build or run your app it will be using the 2.2 release 


GOPATH 


If you are not using modules then you will need to update the Fyne checkout in your go source code. To 
do this execute the following command: 


go get -u fyne.io/fyne/v2 


Any apps without a module file will now use the 2.2 release. 


Fyne command 


You should update the fyne tool for v2.2.0 to get the web driver afyne served support. You can make the 
upgrade by using the go get command similarly to above: 


go get -u fyne.io/fyne/v2/cmd/fyne 


After that completes, check you have the new version installed by running fyne version. 


Changes 


Although this release is backwards compatible so your code will compile and run as expected, there are 
some changes which you may notice. 
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@ Toolbar item constructors now return concrete types instead of Toolbarltem 
@ Low importance buttons no longer draw button color as a background 
@ ProgressBar widget height is now consistent with other widgets 


Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 
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Fyne API "fyne.Animation" 


fyne.Animation 


import "fyne.io/fyne/v2" 


Usage 


type Animation 


type Animation struct { 
AutoReverse bool 


Curve AnimationCurve 
Duration time.Duration 

RepeatCount int 

Tick func (float32) 


} 


Animation represents an animated element within a Fyne canvas. These animations may control individual 
objects or entire scenes. 


Since: 2.0 
func NewAnimation 
func NewAnimation(d time.Duration, fn func(float32)) *Animation 


NewAnimation creates a very basic animation where the callback function will be called for every 
rendered frame between time.Now() and the specified duration. The callback values start at 0.0 and will be 
1.0 when the animation completes. 


Since: 2.0 


func (*Animation) Start 


func (a *Animation) Start () 


Start registers the animation with the application run-loop and starts its execution. 
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func (*Animation) Stop 


func (a *Animation) Stop() 
Stop will end this animation and remove it from the run-loop. 
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fyne.AnimationCurve 


import "fyne.io/fyne/v2" 


Usage 
type AnimationCurve 
type AnimationCurve func(float32) float32 


AnimationCurve represents an animation algorithm for calculating the progress through a timeline. 
Custom animations can be provided by implementing the afunc(float32) float324 definition. The input 
parameter will start at 0.0 when an animation starts and travel up to 1.0 at which point it will end. A linear 
animation would return the same output value as is passed in. 
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Fyne API "fyne.App" 
[Edit me] 


fyne.App 


import "fyne.io/fyne/v2" 


Usage 


type App 


type App interface { 
// Create a new window for the application. 
// The first window to open is considered the "master" and when closed 
// the application will exit. 
NewWindow(title string) Window 


// Open a URL in the default browser application. 
OpenURL (url *url.URL) error 


// Icon returns the application icon, this is used in various ways 
// depending on operating system. 

// This is also the default icon for new windows. 

Icon() Resource 


// SetIcon sets the icon resource used for this application instance. 
SetIcon (Resource) 


// Run the application - this starts the event loop and waits until Quit () 
// is called or the last window closes. 

// This should be called near the end of a main() function as it will block. 
Run () 


// Calling Quit on the application will cause the application to exit 

// cleanly, closing all open windows. 

// This function does no thing on a mobile device as the application lifecycle is 
// managed by the operating system. 

Quit () 


// Driver returns the driver that is rendering this application. 
// Typically not needed for day to day work, mostly internal functionality. 
Driver() Driver 


// UniqueID returns the application unique identifier, if set. 
// This must be set for use of the Preferences() functions... see NewWithId(string) 


UniqueID() string 


// SendNotification sends a system notification that will be displayed in the operating system’s notification area. 
SendNotification (*Notification) 


// Settings return the globally set settings, determining theme and so on. 
Settings() Settings 


// Preferences returns the application preferences, used for storing configuration and state 
Preferences() Preferences 


// Storage returns a storage handler specific to this application. 
Storage() Storage 
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// Lifecycle returns a type that allows apps to hook in to lifecycle events. 
// 

// Since: 2.1 

Lifecycle() Lifecycle 

// Metadata returns the application metadata that was set at compile time. 
// 

// Since: 2.2 

Metadata() AppMetadata 


An App is the definition of a graphical application. Apps can have multiple windows, by default they will 
exit when all windows have been closed. This can be modified using SetMaster() or SetCloseIntercept(). 
To start an application you need to call Run() somewhere in your main() function. Alternatively use the 
window.ShowAndRun() function for your main window. 


func CurrentApp 


func CurrentApp() App 


CurrentApp returns the current application, for which there is only 1 per process. 
Tags: 
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fyne.AppMetadata 


import "fyne.io/fyne/v2" 


Usage 
type AppMetadata 


type AppMetadata struct { 
// ID is the unique ID of this application, used by many distribution platforms. 
ID string 
// Name is the human friendly name of this app. 
Name string 
// Version represents the version of this application, normally following semantic versioning. 
Version string 
// Build is the build number of this app, some times appended to the version number. 
Build int 
// Icon contains, if present, a resource of the icon that was bundled at build time. 
Icon Resource 


AppMetadata captures the build metadata for an application. 


Since: 2.2 
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Fyne API "fyne.BuildType" 


fyne.BuildType 


import "fyne.io/fyne/v2" 


Usage 


type BuildType 


type BuildType int 


BuildType defines different modes that an application can be built using. 


const ( 


Tags: 


// BuildStandard is the normal build mode - it is not debug, test or release mode. 

BuildStandard BuildType = iota 

// BuildDebug is used when a developer would like more information and visual output for app debugging. 
BuildDebug 

// BuildRelease is a final production build, it is like BuildStandard but will use distribution certificates. 
// A release build is typically going to connect to live services and is not usually used during development. 
BuildRelease 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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Fyne API ''fyne.Canvas' 


fyne.Canvas 


import "fyne.io/fyne/v2" 


Usage 


type Canvas 


type Canvas interface { 
Content () CanvasObject 
SetContent (CanvasObject) 


Refresh (CanvasObject) 


// Focus makes the provided item focused. 

// The item has to be added to the contents of the canvas before calling this. 

Focus (Focusable) 

// FocusNext focuses the next focusable item. 

// If no item is currently focused, the first focusable item is focused. 

// If the last focusable item is currently focused, the first focusable item is focused. 
// 

// Since: 2.0 

FocusNext () 

// FocusPrevious focuses the previous focusable item. 

// If no item is currently focused, the last focusable item is focused. 

// If the first focusable item is currently focused, the last focusable item is focused. 


// 

// Since: 2.0 
FocusPrevious () 
Unfocus () 


Focused() Focusable 


// Size returns the current size of this canvas 

Size() Size 

// Scale returns the current scale (multiplication factor) this canvas uses to render 
// The pixel size of a CanvasObject can be found by multiplying by this value. 
Scale() float32 


// Overlays returns the overlay stack. 
Overlays() OverlayStack 


OnTypedRune() func (rune) 

SetOnTypedRune (func (rune) ) 

OnTypedKey() func (*KeyEvent) 

SetOnTypedKey (func (*KeyEvent) ) 

AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
RemoveShortcut (shortcut Shortcut) 


Capture() image.Image 
// PixelCoordinateForPosition returns the x and y pixel coordinate for a given position on this canvas. 


// This can be used to find absolute pixel positions or pixel offsets relative to an object top left. 
PixelCoordinateForPosition(Position) (int, int) 
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// InteractiveArea returns the position and size of the central interactive area. 
// Operating system elements may overlap the portions outside this area and widgets should avoid being outside. 


if 
// Since: 1.4 
InteractiveArea() (Position, Size) 


Canvas defines a graphical canvas to which a CanvasObject or Container can be added. Each canvas has a 
scale which is automatically applied during the render process. 
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If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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Fyne API "'fyne.CanvasObject"' 


fyne.CanvasObject 


import "fyne.io/fyne/v2" 


Usage 


type CanvasObject 
type CanvasObject interface { 


// MinSize returns the minimum size this object needs to be drawn. 

MinSize() Size 

// Move moves this object to the given position relative to its parent. 

// This should only be called if your object is not in a container with a layout manager. 
Move (Position) 

// Position returns the current position of the object relative to its parent. 

Position() Position 

// Resize resizes this object to the given size. 

// This should only be called if your object is not in a container with a layout manager. 
Resize (Size) 

// Size returns the current size of this object. 

Size() Size 


// Hide hides this object. 

Hide () 

// Visible returns whether this object is visible or not. 
Visible() bool 

// Show shows this object. 

Show () 


// Refresh must be called if this object should be redrawn because its inner state changed. 
Refresh () 


CanvasObject describes any graphical object that can be added to a canvas. Objects have a size and 
position that can be controlled through this API. MinSize is used to determine the minimum size which 
this object should be displayed. An object will be visible by default but can be hidden with Hide() and 
re-shown with Show(). 


Note: If this object is controlled as part of a Layout you should not call Resize(Size) or Move(Position). 
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fyne.Clipboard 


import "fyne.io/fyne/v2" 


Usage 
type Clipboard 


type Clipboard interface { 
// Content returns the clipboard content 
Content () string 
// SetContent sets the clipboard content 
SetContent (content string) 


} 
Clipboard represents the system clipboard interface 
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Fyne API "fyne.Container" 


fyne.Container 


import "fyne.io/fyne/v2" 


Usage 


type Container 


type Container struct { 
Hidden bool // Is this Container hidden 


Layout Layout // The Layout algorithm for arranging child CanvasObjects 
Objects []CanvasObject // The set of CanvasObjects this container holds 


} 


Container is a CanvasObject that contains a collection of child objects. The layout of the children is set by 
the specified Layout. 


func NewContainer 


func NewContainer(objects ...CanvasObject) *Container 
NewContainer returns a new Container instance holding the specified CanvasObjects. 


Deprecated: Use container. NewWithoutLayout() to create a container that uses manual layout. 


func NewContainerWithLayout 


func NewContainerWithLayout (layout Layout, objects ...CanvasObject) *Container 


NewContainerWithLayout returns a new Container instance holding the specified CanvasObjects which 
will be laid out according to the specified Layout. 


Deprecated: Use container.New() instead 
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func NewContainerWithoutLayout 


func NewContainerWithoutLayout (objects ...CanvasObject) *Container 


NewContainerWithoutLayout returns a new Container instance holding the specified CanvasObjects that 
are manually arranged. 


Deprecated: Use container. NewWithoutLayout() instead 


func (*Container) Add 


func (c *Container) Add(add CanvasObject) 
Add appends the specified object to the items this container manages. 


Since: 1.4 


func (*Container) AddObject 


func (c *Container) AddObject (o CanvasObject) 
AddObject adds another CanvasObject to the set this Container holds. 


Deprecated: Use replacement Add() function 


func (*Container) Hide 

func (c *Container) Hide () 

Hide sets this container, and all its children, to be not visible. 
func (*Container) MinSize 

func (c *Container) MinSize() Size 


MinSize calculates the minimum size of a Container. This is delegated to the Layout, if specified, 
otherwise it will mimic MaxLayout. 


func (*Container) Move 


func (c *Container) Move(pos Position) 


Move the container (and all its children) to a new position, relative to its parent. 


func (*Container) Position 


func (c *Container) Position() Position 


Position gets the current position of this Container, relative to its parent. 
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func (*Container) Refresh 


func (c *Container) Refresh () 

Refresh causes this object to be redrawn in itas current state 
func (*Container) Remove 

func (c *Container) Remove(rem CanvasObject) 


Remove updates the contents of this container to no longer include the specified object. This method is not 
intended to be used inside a loop, to remove all the elements. It is much more efficient to call RemoveAI|Q) 
instead. 


func (*Container) RemoveAll 

func (c *Container) RemoveAll () 

RemoveAll updates the contents of this container to no longer include any objects. 
Since: 2.2 


func (*Container) Resize 


func (c *Container) Resize(size Size) 


Resize sets a new size for the Container. 


func (*Container) Show 


func (c *Container) Show() 


Show sets this container, and all its children, to be visible. 


func (*Container) Size 


func (c *Container) Size() Siz 


Size returns the current size of this container. 


func (*Container) Visible 


func (c *Container) Visible() bool 
Visible returns true if the container is currently visible, false otherwise. 
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Fyne API "fyne.Delta" 


fyne.Delta 


import "fyne.io/fyne/v2" 


Usage 


type Delta 


type Delta struct { 
DX, DY float32 
} 


Delta is a generic X, Y coordinate, size or movement representation. 


func NewDelta 


func NewDelta(dx float32, dy float32) Delta 


NewDelta returns a newly allocated Delta representing a movement in the X and Y axis. 


func (Delta) Components 


func (v Delta) Components() (float32, float32) 


Components returns the X and Y elements of this Delta. 


func (Delta) IsZero 


func (v Delta) IsZero() bool 
IsZero returns whether the Position is at the zero-point. 
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Fyne API "fyne.Device" 


fyne.Device 


import "fyne.io/fyne/v2" 


Usage 


type Device 


type Device interface { 
Orientation() DeviceOrientation 
IsMobile() bool 
IsBrowser() bool 
HasKeyboard() bool 
SystemScaleForWindow (Window) float32 


} 


Device provides information about the devices the code is running on 


func CurrentDevice 


func CurrentDevice() Devic 


CurrentDevice returns the device information for the current hardware (via the driver) 
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Fyne API "fyne.DeviceOrientation"' 


fyne.DeviceOrientation 


import "fyne.io/fyne/v2" 


Usage 


type DeviceOrientation 


type DeviceOrientation int 


DeviceOrientation represents the different ways that a mobile device can be held 


const ( 


Tags: 


// OrientationVertical is the default vertical orientation 

OrientationVertical DeviceOrientation = iota 

// OrientationVerticalUpsideDown is the portrait orientation held upside down 
OrientationVerticalUpsideDown 

// OrientationHorizontalLeft is used to indicate a landscape orientation with the top to the left 
OrientationHorizontalLeft 

// OrientationHorizontalRight is used to indicate a landscape orientation with the top to the right 
OrientationHorizontalRight 
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fyne.Disableable 


import "fyne.io/fyne/v2" 


Usage 

type Disableable 

type Disableable interface { 
Enable () 
Disable () 
Disabled() bool 


} 


Disableable describes any CanvasObject that can be disabled. This is primarily used with objects that also 
implement the Tappable interface. 
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fyne.DoubleTappable 


import "fyne.io/fyne/v2" 


Usage 
type DoubleTappable 


type DoubleTappable interface { 
DoubleTapped (*PointEvent) 


} 
DoubleTappable describes any CanvasObject that can also be double tapped. 
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import "fyne.io/fyne/v2" 


Usage 


type DragEvent 


type DragEvent struct { 
PointEvent 
Dragged Delta 


} 


DragEvent defines the parameters of a pointer or other drag event. The DraggedX and DraggedY fields 
show how far the item was dragged since the last event. 
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Fyne API "fyne.Draggable"' 


fyne.Draggable 


import "fyne.io/fyne/v2" 


Usage 
type Draggable 


type Draggable interface { 
Dragged (*DragEvent) 
DragEnd () 


} 


Draggable indicates that a CanvasObject can be dragged. This is used for any item that the user has 
indicated should be moved across the screen. 
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Fyne API "fyne.Driver" 


fyne.Driver 


import "fyne.io/fyne/v2" 


Usage 


type Driver 


type Driver interface { 
// CreateWindow creates a new UI Window. 
CreateWindow(string) Window 
// AllWindows returns a slice containing all app windows. 
AllWindows() []Window 


// RenderedTextSize returns the size required to render the given string of specified 
// font size and style. It also returns the height to text baseline, measured from the top. 
RenderedTextSize(text string, fontSize float32, style TextStyle) (size Size, baseline float32) 


// CanvasForObject returns the canvas that is associated with a given CanvasObject. 

CanvasForObject (CanvasObject) Canvas 

// AbsolutePositionForObject returns the position of a given CanvasObject relative to the top/left of a canvas. 
AbsolutePositionForObject (CanvasObject) Position 


// Device returns the device that the application is currently running on. 


Device() Device 
// Run starts the main event loop of the driver. 
Run () 


// Quit closes the driver and open windows, then exit the application. 
// On some some operating systems this does nothing, for example iOS and Android. 
Quit () 


// StartAnimation registers a new animation with this driver and requests it be started. 
StartAnimation (*Animation) 

// StopAnimation stops an animation and unregisters from this driver. 

StopAnimation (*Animation) 


Driver defines an abstract concept of a Fyne render driver. Any implementation must provide at least these 
methods. 
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fyne.Focusable 


import "fyne.io/fyne/v2" 


Usage 


type Focusable 


type Focusable interface { 
// FocusGained is a hook called by the focus handling logic after this object gained the focus. 
FocusGained () 
// FocusLost is a hook called by the focus handling logic after this object lost the focus. 
FocusLost () 


// TypedRune is a hook called by the input handling logic on text input events if this object is focused. 
TypedRune (rune) 


// TypedKey is a hook called by the input handling logic on key events if this object is focused. 
TypedKey (*KeyEvent) 


Focusable describes any CanvasObject that can respond to being focused. It will receive the FocusGained 
and FocusLost events appropriately. When focused it will also have TypedRune called as text is input and 
TypedKey called when other keys are pressed. 


Note: You must not change canvas state (including overlays or focus) in FocusGained or FocusLost or you 
would end up with a dead-lock. 
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Fyne API ''fyne.HardwareKey" 


fyne.HardwareKey 


import "fyne.io/fyne/v2" 


Usage 


type HardwareKey 


type HardwareKey struct { 
// ScanCode represents a hardware ID for (normally desktop) keyboard events. 
ScanCode int 


} 


HardwareKey contains information associated with physical key events Most applications should use 
KeyName for cross-platform compatibility. 
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Fyne API "fyne.KeyboardShortcut"' 


fyne.KeyboardShortcut 


import "fyne.io/fyne/v2" 


Usage 


type KeyboardShortcut 


type KeyboardShortcut interface { 
Shortcut 
Key() KeyName 
Mod() KeyModifier 
} 
KeyboardShortcut describes a shortcut meant to be triggered by a keyboard action. 
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fyne.KeyEvent 


import "fyne.io/fyne/v2" 


Usage 


type KeyEvent 


type KeyEvent struct { 
// Name describes the keyboard event that is consistent across platforms. 
Name KeyName 
// Physical is a platform specific field that reports the hardware information of physical keyboard events. 
Physical HardwareKey 
} 


KeyEvent describes a keyboard input event. 
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[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


2877 


e [ToolbarSpacer[p 4993] 
e [Tree|[p 5002] 
e [TreeNodelD][p 5014] 
@ [List My App][p 5023] 
Fyne API "fyne.KeyModifier"' 


fyne.KeyModifier 


import "fyne.io/fyne/v2" 


Usage 
type KeyModifier 


type KeyModifier int 
KeyModifier represents any modifier key (shift etc.) that is being pressed together with a key. 


Since: 2.2 


const ( 
// KeyModifierShift represents a shift key being held 


// Since: 2.2 
KeyModifierShift KeyModifier = 1 << iota 
// KeyModifierControl represents the ctrl key being held 


// Since: 2.2 
KeyModifierControl 
// KeyModifierAlt represents either alt keys being held 


// Since: 2.2 
KeyModifierAlt 
// KeyModifierSuper represents either super keys being held 


// Since: 2.2 
KeyModifierSuper 


) 


Tags: 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 
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[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


2882 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


2883 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


2884 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


2885 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
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© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API "fyne.KeyName"' 


fyne.KeyName 


import "fyne.io/fyne/v2" 


Usage 


type KeyName 


type KeyName string 


KeyName represents the name of a key that has been pressed. 


const ( 
// KeyEscape is the "esc" key 
KeyEscape KeyName = "Escape" 
// KeyReturn is the carriage return (main keyboard) 
KeyReturn KeyName = "Return" 
// KeyTab is the tab advance key 
KeyTab KeyName = "Tab" 
// KeyBackspace is the delete-before-cursor key 
KeyBackspace KeyName = "BackSpace" 
// KeyInsert is the insert mode key 
KeyInsert KeyName = "Insert" 
// KeyDelete is the delete-after-cursor key 
KeyDelete KeyName = "Delete" 
// KeyRight is the right arrow key 
KeyRight KeyName = "Right" 
// KeyLeft is the left arrow key 
KeyLeft KeyName = "Left" 
// KeyDown is the down arrow key 
KeyDown KeyName = "Down" 
// KeyUp is the up arrow key 
KeyUp KeyName = "Up" 
// KeyPageUp is the page up num-pad key 
KeyPageUp KeyName = "Prior" 
// KeyPageDown is the page down num-pad key 
KeyPageDown KeyName = "Next" 
// KeyHome is the line-home key 
KeyHome KeyName = "Home" 
// KeyEnd is the line-end key 
KeyEnd KeyName = "End" 
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// KeyFl is the first function key 
KeyFl KeyName = "F1" 

// KeyF2 is the second function key 
KeyF2 KeyName = "F2" 

// KeyF3 is the third function key 
KeyF3 KeyName = "F3" 

// KeyF4 is the fourth function key 
KeyF4 KeyName = "F4" 

// KeyF5 is the fifth function key 
KeyF5 KeyName = "F5" 

// KeyF6 is the sixth function key 
KeyF6 KeyName = "F6" 

// KeyF7 is the seventh function key 
KeyF7 KeyName = "F7" 

// KeyF8 is the eighth function key 
KeyF8 KeyName = "F8" 

// KeyF9 is the ninth function key 
KeyF9 KeyName = "F9" 

// KeyF10 is the tenth function key 
KeyF10 KeyName = "F10" 

// KeyF1l1 is the eleventh function key 
KeyF1ll KeyName = "F11" 

// KeyF12 is the twelfth function key 
KeyF12 KeyName = "F12" 


// KeyEnter is the enter/ return key (keypad) 
KeyEnter KeyName = "KP_Enter" 


// KeyO represents the key 0 
KeyO KeyName = "0" 
// Keyl represents the key 1 
Keyl KeyName = "1" 
// Key2 represents the key 2 
Key2 KeyName = "2" 
// Key3 represents the key 3 
Key3 KeyName = "3" 
// Key4 represents the key 4 
Key4 KeyName = "4" 
// Key5 represents the key 5 
Key5 KeyName = "5" 
// Key6 represents the key 6 
Key6 KeyName = "6" 
// Key7 represents the key 7 
Key7 KeyName = "7" 
// Key8 represents the key 8 
Key8 KeyName = "8" 
// Key9 represents the key 9 
Key9 KeyName = "9" 
// KeyA represents the key A 
KeyA KeyName = "A" 
// KeyB represents the key B 
KeyB KeyName = "B" 
// KeyC represents the key C 
KeyC KeyName = "C" 
// KeyD represents the key D 
KeyD KeyName = "D" 
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tH 


y 


(full stop) 


// KeyE represents the key 
KeyE KeyName = "EK" 

// KeyF represents the key 
KeyF KeyName = "F" 

// KeyG represents the key 
KeyG KeyName = "G" 

// KeyH represents the key 
KeyH KeyName = "H" 

// KeyI represents the key 
KeyI KeyName = "I" 

// Keyd represents the key 
KeyJ KeyName = "J" 

// KeyK represents the key 
KeyK KeyName = "K" 

// KeyL represents the key 
KeyL KeyName = "L" 

// KeyM represents the key 
KeyM KeyName = "M" 

// KeyN represents the key 
KeyN KeyName = "N" 

// KeyO represents the key 
KeyO KeyName = "0" 

// KeyP represents the key 
KeyP KeyName = "P" 

// KeyQ represents the key 
KeyQ KeyName = "Q" 

// KeyR represents the key 
KeyR KeyName = "R" 

// KeyS represents the key 
KeyS KeyName = "S" 

// KeyT represents the key 
KeyT KeyName = "T" 

// KeyU represents the key 
KeyU KeyName = "U" 

// KeyV represents the key 
KeyV KeyName = "Vv" 

// KeyW represents the key 
KeyW KeyName = "W" 

// KeyX represents the key 
KeyX KeyName = "X" 

// KeyY represents the key 
KeyY KeyName = "Y" 

// KeyZ represents the key 
KeyZ KeyName = "Z" 

// KeySpace is the space k 
KeySpace KeyName = "Space" 
// KeyApostrophe is the key "’" 
KeyApostrophe KeyName = "/" 
// KeyComma is the key "," 
KeyComma KeyName = "," 

// KeyMinus is the key "-" 
KeyMinus KeyName = "-" 

// KeyPeriod is the key "." 
KeyPeriod KeyName wet 

// KeySlash is the key "/" 
KeySlash KeyName = "/" 
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// KeyBackslash is the key "\" 

KeyBackslash KeyName = "\\" 

// KeyLeftBracket is the key "[" 
KeyLeftBracket KeyName = "[" 

// KeyRightBracket is the key "]" 
KeyRightBracket KeyName = "]" 

// KeySemicolon is the key ";" 

KeySemicolon KeyName = ";" 

// KeyEqual is the key "=" 

KeyEqual KeyName = "=" 

// KeyAsterisk is the keypad key "*" 
KeyAsterisk KeyName = "*" 

// KeyPlus is the keypad key "+" 

KeyPlus KeyName = "+" 

// KeyBackTick is the key "*‘" on a US keyboard 
KeyBackTick KeyName = "*‘" 

// KeyUnknown is used for key events where the underlying 


// event that Fyne could not decode. 


// 


// Since: 2.1 
KeyUnknown KeyName = "" 


) 


Tags: 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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Fyne API "'fyne.Layout"' 


fyne.Layout 


import "fyne.io/fyne/v2" 


Usage 


type Layout 


type Layout interface { 


} 


// Layout will manipulate the listed CanvasObjects Size and Position 
// to fit within the specified size. 

Layout ([]CanvasObject, Size) 

// MinSize calculates the smallest size that will fit the listed 

// CanvasObjects using this Layout algorithm. 

MinSize(objects []CanvasObject) Size 


Layout defines how CanvasObjects may be laid out in a specified Size. 
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Fyne API "fyne.LegacyTheme"' 


fyne.LegacyTheme 


import "fyne.io/fyne/v2" 


Usage 


type Legacy Theme 


type LegacyTheme interface { 
BackgroundColor() color.Color 
ButtonColor() color.Color 
DisabledButtonColor() color.Color 
TextColor() color.Color 
DisabledTextColor() color.Color 
PlaceHolderColor() color.Color 
PrimaryColor() color.Color 
HoverColor() color.Color 
FocusColor() color.Color 
ScrollBarColor() color.Color 
ShadowColor() color.Color 


TextSize() int 

TextFont() Resource 
TextBoldFont() Resource 
TextItalicFont() Resource 
TextBoldItalicFont() Resource 
TextMonospaceFont () Resource 


Padding() int 


IconInlineSize() int 
ScrollBarSize() int 
ScrollBarSmallSize() int 


LegacyTheme defines the requirements of any Fyne theme. This was previously called Theme and is kept 
for simpler transition of applications built before v2.0.0. 
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fyne.Lifecycle 


import "fyne.io/fyne/v2" 


Usage 


type Lifecycle 


type Lifecycle interface { 
// SetOnEnteredForeground hooks into the app becoming foreground and gaining focus. 
SetOnEnteredForeground (func () ) 
// SetOnExitedForeground hooks into the app losing input focus and going into the background. 
SetOnExitedForeground (func () ) 
// SetOnStarted hooks into an event that says the app is now running. 
SetOnStarted (func () ) 
// SetOnStopped hooks into an event that says the app is no longer running. 
SetOnStopped (func () ) 


Lifecycle represents the various phases that an app can transition through. 
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Fyne API "fyne.ListableURI" 


fyne.ListableURI 


import "fyne.io/fyne/v2" 


Usage 
type ListableURI 


type ListableURI interface { 
URI 


// List returns a list of child URIs of this URI. 
List() ([]URI, error) 
} 


ListableURI represents a URI that can have child items, most commonly a directory on disk in the native 
filesystem. 
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fyne.MainMenu 


import "fyne.io/fyne/v2" 


Usage 


type MainMenu 


type MainMenu struct { 
Items []*Menu 


} 


MainMenu defines the data required to show a menu bar (desktop) or other appropriate top level menu. 


func NewMainMenu 


func NewMainMenu(items ...*Menu) *MainMenu 


NewMainMenu creates a top level menu structure used by fyne. Window for displaying a menubar (or 
appropriate equivalent). 


func (*MainMenu) Refresh 


func (m *MainMenu) Refresh () 
Refresh will instruct any rendered menus using this struct to update their display. 
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Fyne API "fyne.Menu" 


fyne.Menu 


import "fyne.io/fyne/v2" 


Usage 


type Menu 


type Menu struct { 
Label string 
Items []*MenuItem 


} 


Menu stores the information required for a standard menu. A menu can pop down from a MainMenu or 
could be a pop out menu. 


func NewMenu 
func NewMenu(label string, items ...*MenuItem) *Menu 


NewMent creates a new menu given the specified label (to show in a MainMenu) and list of items to 
display. 


func (*Menu) Refresh 
func (m *Menu) Refresh () 
Refresh will instruct this menu to update its display. 
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Fyne API "fyne.Menultem"' 


fyne.Menultem 


import "fyne.io/fyne/v2" 


Usage 


type Menultem 


type MenuItem struct { 
ChildMenu *Menu 
// Since: 2.1 


IsQuit bool 
IsSeparator bool 
Label string 
Action func () 


// Since: 2.1 
Disabled bool 

// Since: 2.1 
Checked bool 

// Since: 2.2 
Icon Resource 

// Since: 2.2 
Shortcut Shortcut 

} 


Menultem is a single item within any menu, it contains a display Label and Action function that is called 
when tapped. 


func NewMenultem 


func NewMenulItem(label string, action func()) *MenuItem 


NewMenultem creates a new menu item from the passed label and action parameters. 
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func NewMenulItemSeparator 


func NewMenulItemSeparator() *MenuItem 
NewMenultemSeparator creates a menu item that is to be used as a separator. 
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Fyne API "fyne.Notification" 


fyne.Notification 


import "fyne.io/fyne/v2" 


Usage 


type Notification 


type Notification struct { 
Title, Content string 
} 


Notification represents a user notification that can be sent to the operating system. 


func NewNotification 


func NewNotification(title, content string) *Notification 
NewNotification creates a notification that can be passed to App.SendNotification. 
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fyne.OverlayStack 


import "fyne.io/fyne/v2" 


Usage 


type OverlayStack 


type OverlayStack interface { 
// Add adds an overlay on the top of the overlay stack. 
Add(overlay CanvasObject) 
// List returns the overlays currently on the overlay stack. 
List() []CanvasObject 
// Remove removes the given object and all objects above it from the overlay stack. 
Remove (overlay CanvasObject) 
// Top returns the top-most object of the overlay stack. 
Top() CanvasObject 
} 


OverlayStack is a stack of CanvasObjects intended to be used as overlays of a Canvas. 
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fyne.PointEvent 


import "fyne.io/fyne/v2" 


Usage 


type PointEvent 


type PointEvent struct { 
AbsolutePosition Position // The absolute position of the event 
Position Position // The relative position of the event 


} 


PointEvent describes a pointer input event. The position is relative to the top-left of the CanvasObject this 
is triggered on. 
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Fyne API "fyne.Position" 


fyne.Position 


import "fyne.io/fyne/v2" 


Usage 


type Position 


type Position struct { 
X float32 // The position from the parent’s left edg 
Y float32 // The position from the parent’s top edge 


} 


Position describes a generic X, Y coordinate relative to a parent Canvas or CanvasObject. 


func NewPos 


func NewPos(x float32, y float32) Position 


NewPos returns a newly allocated Position representing the specified coordinates. 


func (Position) Add 


func (p Position) Add(v Vector2) Position 


Add returns a new Position that is the result of offsetting the current position by p2 X and Y. 


func (Position) AddX Y 


func (p Position) AddXY(x, y float32) Position 


AddXyY returns a new Position by adding x and y to the current one. 
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func (Position) Components 


func (p Position) Components() (float32, float32) 

Components returns the X and Y elements of this Position 

func (Position) IsZero 

func (p Position) IsZero() bool 

IsZero returns whether the Position is at the zero-point. 

func (Position) Subtract 

func (p Position) Subtract(v Vector2) Position 

Subtract returns a new Position that is the result of offsetting the current position by p2 -X and -Y. 
func (Position) SubtractX Y 

func (p Position) SubtractXY(x, y float32) Position 

SubtractXY returns a new Position by subtracting x and y from the current one. 
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Fyne API "fyne.Preferences"' 


fyne.Preferences 


import "fyne.io/fyne/v2" 


Usage 


type Preferences 


type Preferences interface { 
// Bool looks up a boolean value for the key 
Bool (key string) bool 


// BoolWithFallback looks up a boolean value and returns the given fallback if not found 


BoolWithFallback(key string, fallback bool) bool 
// SetBool saves a boolean value for the given key 
SetBool (key string, value bool) 


// Float looks up a float64 value for the key 

Float (key string) float64 

// FloatWithFallback looks up a float64 value and returns the given fallback 
FloatWithFallback(key string, fallback float64) floaté64 

// SetFloat saves a float64 value for the given key 

SetFloat (key string, value float64) 


// Int looks up an integer value for the key 
Int (key string) int 


if not found 


// IntWithFallback looks up an integer value and returns the given fallback if not found 


IntWithFallback(key string, fallback int) int 
// SetInt saves an integer value for the given key 
SetInt (key string, value int) 


// String looks up a string value for the key 

String(key string) string 

// StringWithFallback looks up a string value and returns the given fallback 
StringWithFallback (key, fallback string) string 

// SetString saves a string value for the given key 

SetString(key string, value string) 


// RemoveValue removes a value for the given key (not currently supported on 
RemoveValue (key string) 


// AddChangeListener allows code to be notified when some preferences change. 


AddChangeListener (func () ) 


Preferences describes the ways that an app can save and load user preferences 
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Fyne API "fyne.Resource"' 


fyne.Resource 


import "fyne.io/fyne/v2" 


Usage 


type Resource 


type Resource interface { 
Name() string 
Content () []byte 


} 


Resource represents a single binary resource, such as an image or font. A resource has an identifying name 
and byte array content. The serialised path of a resource can be obtained which may result in a blocking 
filesystem write operation. 


func LoadResourceFromPath 


func LoadResourceFromPath(path string) (Resource, error) 


LoadResourceFromPath creates a new StaticResource in memory using the contents of the specified file. 


func LoadResourceFromURLString 


func LoadResourceFromURLString(urlStr string) (Resource, error) 


LoadResourceFromURLString creates a new StaticResource in memory using the body of the specified 
URL. 
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fyne.Scrollable 


import "fyne.io/fyne/v2" 


Usage 
type Scrollable 


type Scrollable interface { 
Scrolled(*ScrollEvent) 


} 


Scrollable describes any CanvasObject that can also be scrolled. This is mostly used to implement the 
widget.ScrollContainer. 
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fyne.ScrollEvent 


import "fyne.io/fyne/v2" 


Usage 


type ScrollEvent 


type ScrollEvent struct { 
PointEvent 
Scrolled Delta 


} 


ScrollEvent defines the parameters of a pointer or other scroll event. The DeltaX and DeltaY represent 
how large the scroll was in two dimensions. 
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Fyne API "'fyne.SecondaryTappable"' 


fyne.SecondaryTappable 


import "fyne.io/fyne/v2" 


Usage 
type SecondaryTappable 


type SecondaryTappable interface { 
TappedSecondary (*PointEvent) 


} 
SecondaryTappable describes a CanvasObject that can be right-clicked or long-tapped. 
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Fyne API "'fyne.Settings"' 


fyne.Settings 


import "fyne.io/fyne/v2" 


Usage 


type Settings 


type Settings interface { 
Theme() Theme 
Set Theme (Theme) 
// ThemeVariant defines which preferred version of a theme should be used (i.e. light or dark) 
// 
// Since: 2.0 
ThemeVariant () ThemeVariant 
Scale() float32 
// PrimaryColor indicates a user preference for a named primary color 
// 
// Since: 1.4 
PrimaryColor() string 


AddChangeListener (chan Settings) 
BuildType() BuildType 


Settings describes the application configuration available. 
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Fyne API "fyne.Shortcut" 


fyne.Shortcut 


import "fyne.io/fyne/v2" 


Usage 


type Shortcut 


type Shortcut interface { 
ShortcutName() string 


} 
Shortcut is the interface used to describe a shortcut action 
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Fyne API "fyne.Shortcutable"' 


fyne.Shortcutable 


import "fyne.io/fyne/v2" 


Usage 


type Shortcutable 


type Shortcutable interface { 
TypedShortcut (Shortcut) 
} 


Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and 
paste). 
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fyne.ShortcutCopy 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutCopy 


type ShortcutCopy struct { 
Clipboard Clipboard 
} 


ShortcutCopy describes a shortcut copy action. 


func (*ShortcutCopy) Key 


func (se *ShortcutCopy) Key() KeyName 
Key returns the KeyName for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutCopy) Mod 


func (se *ShortcutCopy) Mod() KeyModifier 
Mod returns the KeyModifier for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutCopy) ShortcutName 


func (se *ShortcutCopy) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.ShortcutCut" 


fyne.ShortcutCut 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutCut 


type ShortcutCut struct { 
Clipboard Clipboard 
} 


ShortcutCut describes a shortcut cut action. 


func (*ShortcutCut) Key 


func (se *ShortcutCut) Key() KeyName 
Key returns the KeyName for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutCut) Mod 


func (se *ShortcutCut) Mod() KeyModifier 
Mod returns the KeyModifier for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutCut) ShortcutName 


func (se *ShortcutCut) ShortcutName() string 
ShortcutName returns the shortcut name 
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fyne.ShortcutHandler 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutHandler 


type ShortcutHandler struct { 
} 


ShortcutHandler is a default implementation of the shortcut handler for the canvasObject 


func (*ShortcutHandler) AddShortcut 


func (sh *ShortcutHandler) AddShortcut (shortcut Shortcut, handler func(shortcut Shortcut) ) 
AddShortcut register a handler to be executed when the shortcut action is triggered 

func (*ShortcutHandler) RemoveShortcut 

func (sh *ShortcutHandler) RemoveShortcut (shortcut Shortcut) 

RemoveShortcut removes a registered shortcut 

func (*ShortcutHandler) TypedShortcut 

func (sh *ShortcutHandler) TypedShortcut (shortcut Shortcut) 

TypedShortcut handle the registered shortcut 
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Fyne API "fyne.ShortcutPaste"' 


fyne.ShortcutPaste 


import "fyne.io/fyne/v2" 


Usage 


type ShortcutPaste 


type ShortcutPaste struct { 
Clipboard Clipboard 
} 


ShortcutPaste describes a shortcut paste action. 


func (*ShortcutPaste) Key 


func (se *ShortcutPaste) Key() KeyNam 
Key returns the KeyName for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutPaste) Mod 


func (se *ShortcutPaste) Mod() KeyModifier 
Mod returns the KeyModifier for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutPaste) ShortcutName 


func (se *ShortcutPaste) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "'fyne.ShortcutSelectAll"' 


fyne.ShortcutSelectAll 


import "fyne.io/fyne/v2" 


Usage 
type ShortcutSelectAll 
type ShortcutSelectAll struct{} 


ShortcutSelectAll describes a shortcut selectAll action. 


func (*ShortcutSelectAll) Key 


func (se *ShortcutSelectAll) Key() KeyName 
Key returns the KeyName for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutSelectAll) Mod 


func (se *ShortcutSelectAll) Mod() KeyModifier 
Mod returns the KeyModifier for this shortcut. 


Implements: KeyboardShortcut 


func (*ShortcutSelectAll) ShortcutName 


func (se *ShortcutSelectAll) ShortcutName() string 
ShortcutName returns the shortcut name 
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Fyne API "fyne.Size" 


fyne.Size 


import "fyne.io/fyne/v2" 


Usage 


type Size 


type Size struct { 
Width float32 // The number of units along the X axis. 
Height float32 // The number of units along the Y axis. 


} 


Size describes something with width and height. 


func MeasureText 


func MeasureText (text string, size float32, style TextStyle) Siz 


MeasureText uses the current driver to calculate the size of text when rendered. 


func NewSize 


func NewSize(w float32, h float32) Size 


NewSize returns a newly allocated Size of the specified dimensions. 


func (Size) Add 


func (s Size) Add(v Vector2) Size 


Add returns a new Size that is the result of increasing the current size by s2 Width and Height. 
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func (Size) AddWidthHeight 


func (s Size) AddWidthHeight (width, height float32) Size 
AddWidthHeight returns a new Size by adding width and height to the current one. 
func (Size) Components 

func (s Size) Components() (float32, float32) 

Components returns the Width and Height elements of this Size 

func (Size) IsZero 

func (s Size) IsZero() bool 

IsZero returns whether the Size has zero width and zero height. 

func (Size) Max 

func (s Size) Max(v Vector2) Size 

Max returns a new Size that is the maximum of the current Size and s2. 

func (Size) Min 

func (s Size) Min(v Vector2) Size 

Min returns a new Size that is the minimum of the current Size and s2. 

func (Size) Subtract 

func (s Size) Subtract(v Vector2) Size 

Subtract returns a new Size that is the result of decreasing the current size by s2 Width and Height. 
func (Size) SubtractWidthHeight 

func (s Size) SubtractWidthHeight (width, height float32) Size 
SubtractWidthHeight returns a new Size by subtracting width and height from the current one. 
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Fyne API "fyne.StaticResource"' 


fyne.StaticResource 


import "fyne.io/fyne/v2" 


Usage 


type StaticResource 


type StaticResource struct { 
StaticName string 
StaticContent []byte 
} 


StaticResource is a bundled resource compiled into the application. These resources are normally 
generated by the fyne_bundle command included in the Fyne toolkit. 


func NewStaticResource 
func NewStaticResource(name string, content []byte) *StaticResource 


NewStaticResource returns a new static resource object with the specified name and content. Creating a 
new static resource in memory results in sharable binary data that may be serialised to the system cache 
location. 


func (*StaticResource) Content 


func (r *StaticResource) Content() []byte 


Content returns the bytes of the bundled resource, no compression is applied but any compression on the 
resource is retained. 


func (*StaticResource) GoString 


func (r *StaticResource) GoString() string 


GoString converts a Resource object to Go code. This is useful if serialising to a Go file for compilation 
into a binary. 
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func (*StaticResource) Name 


func (r *StaticResource) Name() string 
Name returns the unique name of this resource, usually matching the file it was generated from. 
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Fyne API "'fyne.Storage" 


fyne.Storage 


import "fyne.io/fyne/v2" 


Usage 


type Storage 


type Storage interface { 
RootURI() URI 


Create (name string) (URIWriteCloser, error) 
Open(name string) (URIReadCloser, error) 
Save(name string) (URIWriteCloser, error) 


Remove (name string) error 


List() []string 
} 


Storage is used to manage file storage inside an application sandbox. The files managed by this interface 
are unique to the current application. 
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fyne.String Validator 


import "fyne.io/fyne/v2" 


Usage 

type StringValidator 

type StringValidator func(string) error 

String Validator is a function signature for validating string inputs. 


Since: 1.4 
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fyne.Tabbable 


import "fyne.io/fyne/v2" 


Usage 
type Tabbable 


type Tabbable interface { 
// AcceptsTab() is a hook called by the key press handling logic. 
// Tf it returns true then the Tab key events will be sent using TypedKey. 
AcceptsTab() bool 


} 
Tabbable describes any object that needs to accept the Tab key presses. 
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Fyne API "fyne.Tappable"' 


fyne.Tappable 


import "fyne.io/fyne/v2" 


Usage 
type Tappable 


type Tappable interface { 
Tapped (*PointEvent) 


} 


Tappable describes any CanvasObject that can also be tapped. This should be implemented by buttons etc 
that wish to handle pointer interactions. 
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fyne.TextAlign 


import "fyne.io/fyne/v2" 


Usage 
type TextAlign 


type TextAlign int 


TextAlign represents the horizontal alignment of text within a widget or canvas object. 


const ( 
// TextAlignLeading specifies a left alignment for left-to-right languages. 
TextAlignLeading TextAlign = iota 
// TextAlignCenter places the text centrally within the available space. 
TextAlignCenter 
// TextAlignTrailing will align the text right for a left-to-right language. 
TextAlignTrailing 

) 
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fyne.TextStyle 


import "fyne.io/fyne/v2" 


Usage 


type TextStyle 

type TextStyle struct { 
Bold bool // Should text be bold 
Italic bool // Should text be italic 


Monospace bool // Use the system monospace font instead of regular 
// Since: 2.2 
Symbol bool // Use the system symbol font. 
// Since: 2.1 
TabWidth int // Width of tabs in spaces 
} 


TextStyle represents the styles that can be applied to a text canvas object or text based widget. 
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fyne.TextWrap 


import "fyne.io/fyne/v2" 


Usage 
type TextWrap 


type TextWrap int 


TextWrap represents how text longer than the widgetas width will be wrapped. 


const ( 
// TextWrapOff extends the widget’s width to fit the text, no wrapping is applied. 
TextWrapOff TextWrap = iota 
// TextTruncate trims the text to the widget’s width, no wrapping is applied. 
// Tf an entry is asked to truncate it will provide scrolling capabilities. 
TextTruncate 
// TextWrapBreak trims the line of characters to the widget’s width adding the excess as new line. 
// An Entry with text wrapping will scroll vertically if there is not enough space for all the text. 
TextWrapBreak 
// TextWrapWord trims the line of words to the widget’s width adding the excess as new line. 
// An Entry with text wrapping will scroll vertically if there is not enough space for all the text. 
TextWrapWord 
) 
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fyne. Theme 


import "fyne.io/fyne/v2" 


Usage 


type Theme 


type Theme interface { 
Color (ThemeColorName, ThemeVariant) color.Color 
Font (TextStyle) Resourc 
Icon(ThemeIconName) Resource 
Size(ThemeSizeName) float32 


} 
Theme defines the method to look up colors, sizes and fonts that make up a Fyne theme. 
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fyne. ThemeColorName 


import "fyne.io/fyne/v2" 


Usage 

type ThemeColorName 

type ThemeColorName string 

ThemeColorName is used to look up a colour based on its name. 
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Fyne API "fyne.ThemeIconName"' 


fyne. ThemeIconName 


import "fyne.io/fyne/v2" 


Usage 

type ThemeIconName 

type ThemeIconName string 

ThemelIconName is used to look up an icon based on its name. 
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Fyne API "fyne.ThemeSizeName"' 


fyne. ThemeSizeName 


import "fyne.io/fyne/v2" 


Usage 


type ThemeSizeName 


type ThemeSizeName string 


ThemeSizeName is used to look up a size based on its name. 
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fyne. Theme Variant 


import "fyne.io/fyne/v2" 


Usage 

type ThemeVariant 

type ThemeVariant uint 

ThemeVariant indicates a variation of a theme, such as light or dark. 
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Fyne API "fyne.URI" 


fyne.URI 


import "fyne.io/fyne/v2" 


Usage 
type URI 


type URI interface { 
fmt .Stringer 


// Extension should return the file extension of the resource 

// referenced by the URI. For example, the Extension() of 

// 'file://foo/bar.baz’ is 'baz’. May return an empty string if the 
// cveferenced resource has none. 

Extension() string 


// Name should return the base name of the item referenced by the URI. 
// For example, the Name() of '’file://foo/bar.baz’ is 'bar.baz’. 
Name() string 


// MimeType should return the content type of the resource referenced 
// by the URI. The returned string should be in the format described 
// by Section 5 of RFC2045 ("Content-Type Header Field"). 

MimeType() string 


// Scheme should return the URI scheme of the URI as defined by IETF 
// RFC3986. For example, the Scheme() of 'file://foo/bar.baz* is 


// ‘file’. 

// 

// Scheme should always return the scheme in all lower-case characters. 
Scheme() string 


// Authority should return the URI authority, as defined by IETF 

// RFC3986. 

// 

// NOTE: the RFC3986 can be obtained by combining the User and Host 
// Fields of net/url’s URL structure. Consult IETF RFC3986, section 
f/--3.2, ppe 1Ts 

// 

// Since: 2.0 
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Authority() string 


// Path should return the URI path, 


// 
// Since: 2.0 
Path() string 


// Query should return the URI query, 


// 
// Since: 2.0 
Query() string 


// Fragment should return the URI fragment, 


// RFC3986. 

“ah 

// Since: 2.0 
Fragment () string 


} 


as defined by I! 


as defined by II 


as defined by II 


ETF RFC3986. 


ETF RFC3986. 


ETE 


URI represents the identifier of a resource on a target system. This resource may be a file or another data 


source such as an app or file sharing system. 


In general, it is expected that URI implementations follow IETF RFC3896. Implementations are highly 
recommended to utilize net/url to implement URI parsing methods, especially Scheme(), AUthorityQ, 


Path(), Query(), and Fragment(). 
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fyne. URIReadCloser 


import "fyne.io/fyne/v2" 


Usage 
type URIReadCloser 


type URIReadCloser interface { 
io.ReadCloser 


URI() URI 
} 


URIReadCloser represents a cross platform data stream from a file or provider of data. It may refer to an 
item on a filesystem or data in another application that we have access to. 
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fyne.URIWriteCloser 


import "fyne.io/fyne/v2" 


Usage 
type URIWriteCloser 


type URIWriteCloser interface { 
io.WriteCloser 


URI() URI 
} 


URIWriteCloser represents a cross platform data writer for a file resource. This will normally refer to a 
local file resource. 
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fyne. Validatable 


import "fyne.io/fyne/v2" 


Usage 
type Validatable 


type Validatable interface { 
Validate() error 


// SetOnValidationChanged is used to set the callback that will be triggered when the validation state changes. 
// The function might be overwritten by a parent that cares about child validation (e.g. widget.Form). 
SetOnValidationChanged (func (error) ) 

} 


Validatable is an interface for specifying if a widget is validatable. 
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fyne.Vector2 


import "fyne.io/fyne/v2" 


Usage 


type Vector2 


type Vector2 interface { 
Components() (float32, float32) 
IsZero() bool 
} 
Vector2 marks geometry types that can operate as a coordinate vector. 


Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 


3288 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


3289 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


3290 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


3291 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


3292 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


3293 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


3294 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


3295 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


3296 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
e [TreeNodeID][p 5014] 
@ [List My App][p 5023] 
Fyne API "'fyne. Widget" 


fyne. Widget 


import "fyne.io/fyne/v2" 


Usage 
type Widget 


type Widget interface { 
CanvasObject 


// CreateRenderer returns a new WidgetRenderer for this widget. 
// This should not be called by regular code, it is used internally to render a widget. 


CreateRenderer() WidgetRenderer 


} 


Widget defines the standard behaviours of any widget. This extends the CanvasObject - a widget behaves 
in the same basic way but will encapsulate many child objects to create the rendered widget. 
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fyne.WidgetRenderer 


import "fyne.io/fyne/v2" 


Usage 


type WidgetRenderer 


type WidgetRenderer interface { 


// Destroy is for internal use. 

Destroy () 

// Layout is a hook that is called if the widget needs to be laid out. 

// This should never call Refresh. 

Layout (Size) 

// MinSize returns the minimum size of the widget that is rendered by this renderer. 
MinSize() Size 

// Objects returns all objects that should be drawn. 

Objects() []CanvasObject 

// Refresh is a hook that is called if the widget has updated and needs to be redrawn. 
// This might trigger a Layout. 

Refresh () 


WidgetRenderer defines the behaviour of a widgetas implementation. This is returned from a widgetas 
declarative object through the CreateRenderer() function and should be exactly one instance per widget in 


memory. 
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fyne.Window 


import "fyne.io/fyne/v2" 


Usage 
type Window 


type Window interface { 
// Title returns the current window title. 
// This is typically displayed in the window decorations. 
Title() string 
// SetTitle updates the current title of the window. 
SetTitle (string) 


// FullScreen returns whether or not this window is currently full screen. 
FullScreen() bool 

// SetFullScreen changes the requested fullScreen property 

// true for a fullScreen window and false to unset this. 

SetFullScreen (bool) 


// Resize this window to the requested content siz 

// The result may not be exactly as desired due to various desktop or 
// platform constraints. 

Resize (Size) 


// RequestFocus attempts to raise and focus this window. 

// This should only be called when you are sure the user would want this window 
// to steal focus from any current focused window. 

RequestFocus () 


// FixedSize returns whether or not this window should disable resizing. 
FixedSize() bool 

// SetFixedSize sets a hint that states whether the window should be a fixed 
// size or allow resizing. 

SetFixedSize (bool) 


// CenterOnScreen places a window at the center of the monitor 
// the Window object is currently positioned on. 
CenterOnScreen () 
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// Padded, normally true, states whether the window should have inner 

// padding so that components do not touch the window edge. 

Padded() bool 

// SetPadded allows applications to specify that a window should have 

// no inner padding. Useful for fullscreen or graphic based applications. 
SetPadded (bool) 


// Tcon returns the window icon, this is used in various ways 

// depending on operating system. 

// Most commonly this is displayed on the window border or task switcher. 
Icon() Resource 


// SetIcon sets the icon resource used for this window. 
// Tf none is set should return the application icon. 
SetIcon (Resource) 


// SetMaster indicates that closing this window should exit the app 
SetMaster () 


// MainMenu gets the content of the window’s top level menu. 
MainMenu() *MainMenu 


// SetMainMenu adds a top level menu to this window. 
// The way this is rendered will depend on the loaded driver. 
SetMainMenu (*MainMenu) 


// SetOnClosed sets a function that runs when the window is closed. 
SetOnClosed (func () ) 


// SetCloseIntercept sets a function that runs instead of closing if defined. 
// Close() should be called explicitly in the interceptor to close the window. 
// 

// Since: 1.4 

SetCloseIntercept (func () ) 


// Show the window on screen. 

Show () 

// Hide the window from the user. 

// This will not destroy the window or cause the app to exit. 

Hide () 

// Close the window. 

// If it is the only open window, or the "master" window the app will Quit. 
Close () 


// ShowAndRun is a shortcut to show the window and then run the application. 
// This should be called near th nd of a main() function as it will block. 
ShowAndRun () 


// Content returns the content of this window. 

Content () CanvasObject 

// SetContent sets the content of this window. 

SetContent (CanvasObject) 

// Canvas returns the canvas context to render in the window. 

// This can be useful to set a key handler for the window, for example. 
Canvas() Canvas 
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// Clipboard returns the system clipboard 
Clipboard() Clipboard 


Window describes a user interface window. Depending on the platform an app may have many windows 


or just the one. 
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Fyne API "app" 


app 


import "fyne.io/fyne/v2/app" 


Package app provides app implementations for working with Fyne graphical interfaces. The fastest way to 
get started is to call app.NewQ) which will normally load a new desktop application. If the acia tag is 
passed to go (go run -tags ci myapp.go) it will run an in-memory application. 

Usage 

func New 


func New() fyne.App 


New returns a new application instance with the default driver and no unique ID 


func NewWithID 


func NewWithID(id string) fyne.App 


NewWithID returns a new app instance using the appropriate runtime driver. The ID string should be 
globally unique to this app. 


func SetMetadata 


func SetMetadata(m fyne.AppMetadata) 


SetMetadata overrides the packaged application metadata. This data can be used in many places like 
notifications and about screens. 


types 
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Fyne API "app.SettingsSchema"' 


app.SettingsSchema 


import "fyne.io/fyne/v2/app" 


Usage 


type SettingsSchema 


type SettingsSchema struct { 
// these items are used for global settings load 
ThemeName string ‘json:"theme"* 
Scale float32 ‘json:"scale"* 
PrimaryColor string ‘json:"primary_color"* 


} 


SettingsSchema is used for loading and storing global settings 


func (*SettingsSchema) StoragePath 


func (sc *SettingsSchema) StoragePath() string 
StoragePath returns the location of the settings storage 
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Fyne API "canvas" 


Canvas 


import "fyne.io/fyne/v2/canvas" 
Package canvas contains all of the primitive CanvasObjects that make up a Fyne GUI. 


The types implemented in this package are used as building blocks in order to build higher order 
functionality. These types are designed to be non-interactive, by design. If additional functionality is 
required, itas usually a sign that this type should be used as part of a custom widget. 


Usage 


const ( 
// DurationStandard is the time a standard interface animation will run. 
// 
// Since: 2.0 
DurationStandard = time.Millisecond * 300 
// DurationShort is the time a subtle or small transition should use. 


// 
// Since: 2.0 
DurationShort = time.Millisecond * 150 


func NewColorRGBA Animation 


func NewColorRGBAAnimation(start, stop color.Color, d time.Duration, fn func(color.Color)) *fyne.Animation 


NewColorRGBAAnimation sets up a new animation that will transition from the start to stop Color over 
the specified Duration. The colour transition will move linearly through the RGB colour space. The 
content of fn should apply the color values to an object and refresh it. You should call Start) on the 
returned animation to start it. 


Since: 2.0 
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func NewPositionAnimation 


func NewPositionAnimation(start, stop fyne.Position, d time.Duration, fn func(fyne.Position)) *fyne.Animation 


NewPositionAnimation sets up a new animation that will transition from the start to stop Position over the 
specified Duration. The content of fn should apply the position value to an object for the change to be 
visible. You should call Start() on the returned animation to start it. 


Since: 2.0 


func NewSizeAnimation 


func NewSizeAnimation(start, stop fyne.Size, d time.Duration, fn func(fyne.Size)) *fyne.Animation 


NewSizeAnimation sets up a new animation that will transition from the start to stop Size over the 
specified Duration. The content of fn should apply the size value to an object for the change to be visible. 
You should call Start() on the returned animation to start it. 


Since: 2.0 


func Refresh 


func Refresh(obj fyne.CanvasObject) 


Refresh instructs the containing canvas to refresh the specified obj. 
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Fyne API "canvas.Circle" 


canvas.Circle 


import "fyne.io/fyne/v2/canvas" 


Usage 


type Circle 


type Circle struct { 


Positionl fyne.Position // The current top-left position of the Circle 
Position2 fyne.Position // The current bottomright position of the Circle 
Hidden bool // Is this circle currently hidden 

FillColor color.Color // The circle fill color 

StrokeColor color.Color // The circle stroke color 

StrokeWidth float32 // The stroke width of the circle 


} 


Circle describes a colored circle primitive in a Fyne canvas 


func NewCircle 


func NewCircle(color color.Color) *Circle 
NewCircle returns a new Circle instance 

func (*Circle) Hide 

func (c *Circle) Hide() 

Hide will set this circle to not be visible 

func (*Circle) MinSize 

func (c *Circle) MinSize() fyne.Size 


MinSize for a Circle simply returns Size{1, 1} as there is no explicit content 
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func (*Circle) Move 


func (c *Circle) Move(pos fyne.Position) 


Move the circle object to a new position, relative to its parent / canvas 


func (*Circle) Position 


func (c *Circle) Position() fyne.Position 


Position gets the current top-left position of this circle object, relative to its parent / canvas 


func (*Circle) Refresh 


func (c *Circle) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Circle) Resize 


func (c *Circle) Resize(size fyne.Size) 


Resize sets a new bottom-right position for the circle object If it has a stroke width this will cause it to 
Refresh. 


func (*Circle) Show 


func (c *Circle) Show() 


Show will set this circle to be visible 


func (*Circle) Size 


func (c *Circle) Size() fyne.Siz 


Size returns the current size of bounding box for this circle object 
func (*Circle) Visible 

func (c *Circle) Visible() bool 

Visible returns true if this circle is visible, false otherwise 

Tags: 


If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 


3356 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


3357 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


3358 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


3359 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


3360 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


3361 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


3362 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


3363 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


3364 


© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023} 


Fyne API "canvas.Image"' 


canvas.Image 


import "fyne.io/fyne/v2/canvas" 


Usage 


type Image 
type Image struct { 
// one of the following sources will provide our image data 
File string // Load the image from a file 
Resource fyne.Resource // Load the image from an in-memory resource 
Image image. Image // Specify a loaded image to use in this canvas object 
Translucency float64 // Set a translucency value > 0.0 to fade the image 


FillMode ImageFill // Specify how the image should expand to fill or fit the available space 
ScaleMode ImageScale // Specify the type of scaling interpolation applied to the image 


Image describes a drawable image area that can render in a Fyne canvas The image may be a vector or a 
bitmap representation and it will fill the area. The fill mode can be changed by setting FillMode to a 
different ImageFill. 


func NewImageFromFile 
func NewImageFromFile(file string) *Image 


NewImageFromFile creates a new image from a local file. Images returned from this method will scale to 
fit the canvas object. The method for scaling can be set using the Fill field. 


func NewImageFromImage 
func NewImageFromImage (img image.Image) *Image 


NewlmageFromImage returns a new Image instance that is rendered from the Go image.Image passed in. 
Images returned from this method will scale to fit the canvas object. The method for scaling can be set 
using the Fill field. 
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func NewImageFromReader 


func NewImageFromReader (read io.Reader, name string) *Image 


NewlImageFromReader creates a new image from a data stream. The name parameter is required to 
uniquely identify this image (for caching etc). If the image in this io.Reader is an SVG, the name should 
end a.svga. Images returned from this method will scale to fit the canvas object. The method for scaling 
can be set using the Fill field. 


Since: 2.0 


func NewImageFromResource 


func NewImageFromResource(res fyne.Resource) *Image 


NewImageFromResoutce creates a new image by loading the specified resource. Images returned from 
this method will scale to fit the canvas object. The method for scaling can be set using the Fill field. 


func NewImageFromURI 
func NewImageFromURI (uri fyne.URI) *Image 


NewlmageFromURI creates a new image from named resource. File URIs will read the file path and other 
schemes will download the data into a resource. HTTP and HTTPs URIs will use the GET method by 
default to request the resource. Images returned from this method will scale to fit the canvas object. The 
method for scaling can be set using the Fill field. 


Since: 2.0 
func (*Image) Alpha 
func (i *Image) Alpha() float6é4 


Alpha is a convenience function that returns the alpha value for an image based on its Translucency value. 
The result is 1.0 - Translucency. 


func (*Image) Hide 

func (o *Image) Hide () 

Hide will set this object to not be visible. 
func (*Image) MinSize 

func (o *Image) MinSize() fyne.Size 


MinSize returns the specified minimum size, if set, or {1, 1} otherwise. 
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func (*Image) Move 


func (o *Image) Move(pos fyne.Position) 

Move the object to a new position, relative to its parent. 
func (*Image) Position 

func (o *Image) Position() fyne.Position 


Position gets the current position of this canvas object, relative to its parent. 


func (*Image) Refresh 


func (i *Image) Refresh() 


Refresh causes this object to be redrawn in itas current state 


func (*Image) Resize 


func (i *Image) Resize(s fyne.Size) 


Resize on an image will scale the content or reposition it according to FillMode. It will normally cause a 
Refresh to ensure the pixels are recalculated. 


func (*Image) SetMinSize 


func (o *Image) SetMinSize(size fyne.Size) 


SetMinSize specifies the smallest size this object should be. 


func (*Image) Show 
func (o *Image) Show() 
Show will set this object to be visible. 


func (*Image) Size 


func (o *Image) Size() fyne.Siz 


Size returns the current size of this canvas object. 

func (*Image) Visible 

func (o *Image) Visible() bool 

Visible returns true if this object is visible, false otherwise. 


Tags: 
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Fyne API "canvas.ImageFill" 


canvas.ImageFill 


import "fyne.io/fyne/v2/canvas" 


Usage 
type ImageFill 


type ImageFill int 


ImageFill defines the different type of ways an image can stretch to fill its space. 


const ( 
// ImageFillStretch will scale the image to match the Size() values. 
// This is the default and does not maintain aspect ratio. 
ImageFillStretch ImageFill = iota 
// ImageFillContain makes the image fit within the object Size(), 
// centrally and maintaining aspect ratio. 
// There may be transparent sections top and bottom or left and right. 
ImageFillContain // (Fit) 
// ImageFillOriginal ensures that the container grows to the pixel dimensions 
// required to fit the original image. The aspect of the image will be maintained so, 
// as with ImageFillContain there may be transparent areas around the image. 
// Note that the minSize may be smaller than the image dimensions if scale > 1. 
ImageFillOriginal 
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Fyne API "canvas.I[mageScale" 


canvas.ImageScale 


import "fyne.io/fyne/v2/canvas" 


Usage 


type ImageScale 


type ImageScale int32 


ImageScale defines the different scaling filters used to scaling images 


const ( 


) 


Tags: 


// ImageScaleSmooth will scale the image using ApproxBiLinear filter (or GL equivalent) 
ImageScaleSmooth ImageScale = iota 

// ImageScalePixels will scale the image using NearestNeighbor filter (or GL equivalent) 
ImageScalePixels 

// ImageScaleFastest will scale the image using hardware GPU if available 

// 

// Since: 2.0 

ImageScaleFastest 
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Fyne API "canvas.Line" 


canvas.Line 


import "fyne.io/fyne/v2/canvas" 


Usage 


type Line 


type Line struct { 
Positionl fyne.Position // 
Position2 fyne.Position // 
Hidden bool // 


StrokeColor color.Color // 
StrokeWidth float32 // 
} 


The current top-left position of the Line 


The current bottomright position of the Line 


Is this Line currently hidden 


The line stroke color 


The stroke width of the line 


Line describes a colored line primitive in a Fyne canvas. Lines are special as they can have a negative 
width or height to indicate an inverse slope (i.e. slope up vs down). 


func NewLine 


func NewLine(color color.Color) *Line 


NewLine returns a new Line instance 
func (*Line) Hide 

func (1 *Line) Hide() 

Hide will set this line to not be visible 


func (*Line) MinSize 


func (1 *Line) MinSize() fyne.Size 
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MinSize for a Line simply returns Size{1, 1} as there is no explicit content 


func (*Line) Move 


func (1 *Line) Move(pos fyne.Position) 

Move the line object to a new position, relative to its parent / canvas 
func (*Line) Position 

func (1 *Line) Position() fyne.Position 


Position gets the current top-left position of this line object, relative to its parent / canvas 


func (*Line) Refresh 


func (1 *Line) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Line) Resize 


func (1 *Line) Resize(size fyne.Size) 
Resize sets a new bottom-right position for the line object and it will then be refreshed. 


func (*Line) Show 


func (1 *Line) Show() 


Show will set this line to be visible 


func (*Line) Size 


func (1 *Line) Size() fyne.Siz 

Size returns the current size of bounding box for this line object 

func (*Line) Visible 

func (1 *Line) Visible() bool 

Visible returns true if this line// Show will set this circle to be visible is visible, false otherwise 
Tags: 
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Fyne API "canvas.LinearGradient" 


canvas.LinearGradient 


import "fyne.io/fyne/v2/canvas" 


Usage 


type LinearGradient 


type LinearGradient struct { 

StartColor color.Color // The beginning color of the gradient 

EndColor color.Color // The end color of the gradient 

Angle float64 // The angle of the gradient (0/180 for vertical; 90/270 for horizontal) 
} 


LinearGradient defines a Gradient travelling straight at a given angle. The only supported values for the 
angle are 0 . 0 (vertical) and 90.0 (horizontal), currently. 


func NewHorizontalGradient 
func NewHorizontalGradient (start, end color.Color) *LinearGradient 


NewHorizontalGradient creates a new horizontally travelling linear gradient. The start color will be at the 
left of the gradient and the end color will be at the right. 


func NewLinearGradient 
func NewLinearGradient (start, end color.Color, angle float64) *LinearGradient 


NewLinearGradient creates a linear gradient at a the specified angle. The angle parameter is the degree 
angle along which the gradient is calculated. A NewHorizontalGradient uses 270 degrees and 
NewVerticalGradient is 0 degrees. 


func NewVerticalGradient 


func NewVerticalGradient (start color.Color, end color.Color) *LinearGradient 
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NewVerticalGradient creates a new vertically travelling linear gradient. The start color will be at the top of 
the gradient and the end color will be at the bottom. 


func (*LinearGradient) Generate 

func (g *LinearGradient) Generate(iw, ih int) image.Image 
Generate calculates an image of the gradient with the specified width and height. 
func (*LinearGradient) Hide 

func (o *LinearGradient) Hide() 

Hide will set this object to not be visible. 

func (*LinearGradient) MinSize 

func (o *LinearGradient) MinSize() fyne.Size 

MinSize returns the specified minimum size, if set, or {1, 1} otherwise. 
func (*LinearGradient) Move 

func (o *LinearGradient) Move(pos fyne.Position) 

Move the object to a new position, relative to its parent. 

func (*LinearGradient) Position 

func (o *LinearGradient) Position() fyne.Position 

Position gets the current position of this canvas object, relative to its parent. 
func (*LinearGradient) Refresh 

func (g *LinearGradient) Refresh () 

Refresh causes this object to be redrawn in itas current state 


func (*LinearGradient) Resize 


func (o *LinearGradient) Resize(size fyne.Size) 


Resize sets a new size for the canvas object. 


func (*LinearGradient) SetMinSize 


func (o *LinearGradient) SetMinSize(size fyne.Size) 
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SetMinSize specifies the smallest size this object should be. 


func (*LinearGradient) Show 

func (o *LinearGradient) Show() 

Show will set this object to be visible. 

func (*LinearGradient) Size 

func (o *LinearGradient) Size() fyne.Size 

Size returns the current size of this canvas object. 

func (*LinearGradient) Visible 

func (o *LinearGradient) Visible() bool 

Visible returns true if this object is visible, false otherwise. 
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canvas.RadialGradient 


import "fyne.io/fyne/v2/canvas" 


Usage 


type RadialGradient 


type RadialGradient struct { 

StartColor color.Color // The beginning color of the gradient 
EndColor color.Color // The end color of the gradient 
// The offset of the center for generation of the gradient. 
// This is not a DP measure but relates to the width/height. 
// A value of 0.5 would move the center by the half width/height. 
CenterOffsetX, CenterOffsetY float64 


} 


RadialGradient defines a Gradient travelling radially from a center point outward. 


func NewRadialGradient 


func NewRadialGradient (start, end color.Color) *RadialGradient 
NewRadialGradient creates a new radial gradient. 

func (*RadialGradient) Generate 

func (g *RadialGradient) Generate(iw, ih int) image.Image 

Generate calculates an image of the gradient with the specified width and height. 
func (*RadialGradient) Hide 

func (o *RadialGradient) Hide () 


Hide will set this object to not be visible. 
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func (*RadialGradient) MinSize 


func (o *RadialGradient) MinSize() fyne.Size 

MinSize returns the specified minimum size, if set, or {1, 1} otherwise. 
func (*RadialGradient) Move 

func (o *RadialGradient) Move(pos fyne.Position) 

Move the object to a new position, relative to its parent. 

func (*RadialGradient) Position 

func (o *RadialGradient) Position() fyne.Position 

Position gets the current position of this canvas object, relative to its parent. 
func (*RadialGradient) Refresh 

func (g *RadialGradient) Refresh () 

Refresh causes this object to be redrawn in itas current state 


func (*RadialGradient) Resize 


func (o *RadialGradient) Resize(size fyne.Size) 


Resize sets a new size for the canvas object. 


func (*RadialGradient) SetMinSize 


func (o *RadialGradient) SetMinSize(size fyne.Size) 
SetMinSize specifies the smallest size this object should be. 
func (*RadialGradient) Show 

func (o *RadialGradient) Show() 

Show will set this object to be visible. 

func (*RadialGradient) Size 

func (o *RadialGradient) Size() fyne.Size 


Size returns the current size of this canvas object. 
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func (*RadialGradient) Visible 


func (o *RadialGradient) Visible() bool 
Visible returns true if this object is visible, false otherwise. 
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Fyne API "'canvas.Raster"' 


canvas.Raster 


import "fyne.io/fyne/v2/canvas" 


Usage 


type Raster 
type Raster struct { 


// Render the raster image from code 
Generator func(w, h int) image.Image 


// Set a translucency value > 0.0 to fade the raster 
Translucency float64 
// Specify the type of scaling interpolation applied to the raster if it is not full-size 
// Since: 1.4.1 
ScaleMode ImageScale 
} 


Raster describes a raster image area that can render in a Fyne canvas 


func NewRaster 


func NewRaster(generate func(w, h int) image.Image) *Raster 


NewRaster returns a new Image instance that is rendered dynamically using the specified generate 
function. Images returned from this method should draw dynamically to fill the width and height 
parameters passed to pixelColor. 


func NewRasterFromImage 


func NewRasterFromImage (img image.Image) *Raster 


NewRasterFromImage returns a new Raster instance that is rendered from the Go image.Image passed in. 
Rasters returned from this method will map pixel for pixel to the screen starting img.Bounds().Min pixels 
from the top left of the canvas object. Truncates rather than scales the image. If smaller than the target 
space, the image will be padded with zero-pixels to the target size. 
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func NewRasterWithPixels 


func NewRasterWithPixels(pixelColor func(x, y, w, h int) color.Color) *Raster 


NewRasterWithPixels returns a new Image instance that is rendered dynamically by iterating over the 
specified pixelColor function for each x, y pixel. Images returned from this method should draw 
dynamically to fill the width and height parameters passed to pixelColor. 


func (*Raster) Alpha 
func (r *Raster) Alpha() float64 


Alpha is a convenience function that returns the alpha value for a raster based on its Translucency value. 
The result is 1.0 - Translucency. 


func (*Raster) Hide 

func (o *Raster) Hide() 

Hide will set this object to not be visible. 

func (*Raster) MinSize 

func (o *Raster) MinSize() fyne.Size 

MinSize returns the specified minimum size, if set, or {1, 1} otherwise. 
func (*Raster) Move 

func (o *Raster) Move(pos fyne.Position) 

Move the object to a new position, relative to its parent. 

func (*Raster) Position 

func (o *Raster) Position() fyne.Position 

Position gets the current position of this canvas object, relative to its parent. 
func (*Raster) Refresh 

func (r *Raster) Refresh() 


Refresh causes this object to be redrawn in itas current state 


func (*Raster) Resize 


func (r *Raster) Resize(s fyne.Size) 
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Resize on a raster image causes the new size to be set and then calls Refresh. This causes the underlying 
data to be recalculated and a new output to be drawn. 


func (*Raster) SetMinSize 


func (o *Raster) SetMinSize(size fyne.Size) 


SetMinSize specifies the smallest size this object should be. 


func (*Raster) Show 


func (o *Raster) Show() 


Show will set this object to be visible. 


func (*Raster) Size 


func (o *Raster) Size() fyne.Siz 


Size returns the current size of this canvas object. 


func (*Raster) Visible 


func (o *Raster) Visible() bool 
Visible returns true if this object is visible, false otherwise. 
Tags: 
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Fyne API "canvas.Rectangle" 


canvas.Rectangle 


import "fyne.io/fyne/v2/canvas" 


Usage 


type Rectangle 


type Rectangle struct { 
FillColor color.Color // The rectangle fill color 
StrokeColor color.Color // The rectangle stroke color 
StrokeWidth float32 // The stroke width of the rectangle 


} 


Rectangle describes a colored rectangle primitive in a Fyne canvas 


func NewRectangle 
func NewRectangle(color color.Color) *Rectangle 
NewRectangle returns a new Rectangle instance 


func (*Rectangle) Hide 


func (o *Rectangle) Hide() 


Hide will set this object to not be visible. 


func (*Rectangle) MinSize 


func (o *Rectangle) MinSize() fyne.Size 


MinSize returns the specified minimum size, if set, or {1, 1} otherwise. 
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func (*Rectangle) Move 


func (o *Rectangle) Move(pos fyne.Position) 


Move the object to a new position, relative to its parent. 


func (*Rectangle) Position 


func (o *Rectangle) Position() fyne.Position 


Position gets the current position of this canvas object, relative to its parent. 


func (*Rectangle) Refresh 


func (r *Rectangle) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Rectangle) Resize 


func (r *Rectangle) Resize(s fyne.Size) 


Resize on a rectangle updates the new size of this object. If it has a stroke width this will cause it to 
Refresh. 


func (*Rectangle) SetMinSize 


func (o *Rectangle) SetMinSize(size fyne.Size) 


SetMinSize specifies the smallest size this object should be. 


func (*Rectangle) Show 
func (o *Rectangle) Show() 
Show will set this object to be visible. 


func (*Rectangle) Size 


func (o *Rectangle) Size() fyne.Siz 


Size returns the current size of this canvas object. 


func (*Rectangle) Visible 


func (o *Rectangle) Visible() bool 
Visible returns true if this object is visible, false otherwise. 
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Fyne API "canvas.Text" 


canvas. Text 


import "fyne.io/fyne/v2/canvas" 


Usage 


type Text 


type Text struct { 
Alignment fyne.TextAlign // The alignment of the text content 


Color color.Color // The main text draw color 
Text string // The string content of this Text 
TextSize float32 // Size of the text - if the Canvas scale is 1.0 this will be equivalent to point size 


TextStyle fyne.TextStyle // The style of the text content 


Text describes a text primitive in a Fyne canvas. A text object can have a style set which will apply to the 
whole string. No formatting or text parsing will be performed 


func NewText 

func NewText (text string, color color.Color) *Text 
NewText returns a new Text implementation 

func (*Text) Hide 

func (o *Text) Hide() 

Hide will set this object to not be visible. 

func (*Text) MinSize 

func (t *Text) MinSize() fyne.Size 


MinSize returns the minimum size of this text object based on its font size and content. This is normally 
determined by the render implementation. 
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func (*Text) Move 


func (o *Text) Move(pos fyne.Position) 


Move the object to a new position, relative to its parent. 


func (*Text) Position 

func (o *Text) Position() fyne.Position 

Position gets the current position of this canvas object, relative to its parent. 
func (*Text) Refresh 

func (t *Text) Refresh () 


Refresh causes this object to be redrawn in itas current state 


func (*Text) Resize 


func (o *Text) Resize(size fyne.Size) 
Resize sets a new size for the canvas object. 


func (*Text) SetMinSize 


func (t *Text) SetMinSize(size fyne.Size) 


SetMinSize has no effect as the smallest size this canvas object can be is based on its font size and content. 


func (*Text) Show 


func (o *Text) Show() 


Show will set this object to be visible. 


func (*Text) Size 


func (o *Text) Size() fyne.Size 


Size returns the current size of this canvas object. 


func (*Text) Visible 


func (o *Text) Visible() bool 
Visible returns true if this object is visible, false otherwise. 


Tags: 
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Fyne API "container" 


container 


import "fyne.io/fyne/v2/container" 


Package container provides containers that are used to lay out and organise applications. 


Usage 


const ( 
// ScrollBoth supports horizontal and vertical scrolling. 
ScrollBoth ScrollDirection = widget .ScrollBoth 
// ScrollHorizontalOnly specifies the scrolling should only happen left to right. 
ScrollHorizontalOnly = widget.ScrollHorizontalOnly 
// ScrollVerticalOnly specifies the scrolling should only happen top to bottom. 
ScrollVerticalOnly = widget.ScrollVerticalOnly 
// ScrollNone turns off scrolling for this container. 
// 
// Since: 2.1 
ScrollNone = widget.ScrollNone 


Constants for valid values of ScrollDirection. 
func New 
func New(layout fyne.Layout, objects ...fyne.CanvasObject) *fyne.Container 


New returns a new Container instance holding the specified CanvasObjects which will be laid out 
according to the specified Layout. 


Since: 2.0 


func NewAdaptiveGrid 


func NewAdaptiveGrid(rowcols int, objects ...fyne.CanvasObject) *fyne.Container 


NewAdaptiveGrid creates a new container with the specified objects and using the grid layout. When in a 
horizontal arrangement the rowcols parameter will specify the column count, when in vertical it will 
specify the rows. On mobile this will dynamically refresh when device is rotated. 
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Since: 1.4 


func NewBorder 


func NewBorder (top, bottom, left, right fyne.CanvasObject, objects ...fyne.CanvasObject) *fyne.Container 


NewBorder creates a new container with the specified objects and using the border layout. The top, 
bottom, left and right parameters specify the items that should be placed around edges, the remaining 
elements will be in the center. Nil can be used to an edge if it should not be filled. 


Since: 1.4 


func NewCenter 


func NewCenter(objects ...fyne.CanvasObject) *fyne.Container 
NewCenter creates a new container with the specified objects centered in the available space. 


Since: 1.4 


func NewGridWithColumns 


func NewGridWithColumns(cols int, objects ...fyne.CanvasObject) *fyne.Container 


NewGridWithColumns creates a new container with the specified objects and using the grid layout with a 
specified number of columns. The number of rows will depend on how many children are in the container. 


Since: 1.4 


func NewGridWithRows 


func NewGridWithRows (rows int, objects ...fyne.CanvasObject) *fyne.Container 


NewGridWithRows creates a new container with the specified objects and using the grid layout with a 
specified number of rows. The number of columns will depend on how many children are in the container. 


Since: 1.4 


func NewGridWrap 


func NewGridWrap(size fyne.Size, objects ...fyne.CanvasObject) *fyne.Container 


NewGridWrap creates a new container with the specified objects and using the gridwrap layout. Every 
element will be resized to the size parameter and the content will arrange along a row and flow to a new 
row if the elements donat fit. 


Since: 1.4 
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func NewHBox 


func NewHBox(objects ...fyne.CanvasObject) *fyne.Container 


NewHBox creates a new container with the specified objects and using the HBox layout. The objects will 
be placed in the container from left to right. 


Since: 1.4 

func NewMax 

func NewMax(objects ...fyne.CanvasObject) *fyne.Container 

NewMax creates a new container with the specified objects filling the available space. 
Since: 1.4 

func NewPadded 

func NewPadded(objects ...fyne.CanvasObject) *fyne.Container 
NewPadded creates a new container with the specified objects inset by standard padding size. 
Since: 1.4 

func NewV Box 

func NewVBox(objects ...fyne.CanvasObject) *fyne.Container 


NewVBox creates a new container with the specified objects and using the VBox layout. The objects will 
be stacked in the container from top to bottom. 


Since: 1.4 


func NewWithoutLayout 


func NewWithoutLayout (objects ...fyne.CanvasObject) *fyne.Container 


NewWithoutLayout returns a new Container instance holding the specified CanvasObjects that are 
manually arranged. 


Since: 2.0 
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© [List My Applip 5023} 


Fyne API "'container.AppTabs"' 


container.AppTabs 


import "fyne.io/fyne/v2/container" 


Usage 
type AppTabs 


type AppTabs struct { 
widget .BaseWidget 


Items []*TabItem 


// Deprecated: Use ‘OnSelected func(*TabItem) * instead. 
OnChanged func (*TabItem) 
OnSelected func (*TabItem) 
OnUnselected func (*TabItem) 


} 


AppTabs container is used to split your application into various different areas identified by tabs. The tabs 
contain text and/or an icon and allow the user to switch between the content specified in each TabItem. 
Each item is represented by a button at the edge of the container. 


Since: 1.4 


func NewAppTabs 


func NewAppTabs (items ...*TabItem) *AppTabs 
NewAppTabs creates a new tab container that allows the user to choose between different areas of an app. 


Since: 1.4 
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func (*AppTabs) Append 


func (t *AppTabs) Append(item *TabItem) 


Append adds a new TablItem to the end of the tab bar. 


func (*AppTabs) CreateRenderer 


func (t *AppTabs) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


Implements: fyne.Widget 


func (*“AppTabs) CurrentTab 


func (t *AppTabs) CurrentTab() *TabItem 
CurrentTab returns the currently selected TabItem. 


Deprecated: Use ‘AppTabs.Selected() *TabItem‘ instead. 


func (*“AppTabs) CurrentTabIndex 


func (t *AppTabs) CurrentTabIndex() int 
CurrentTabIndex returns the index of the currently selected TabItem. 


Deprecated: Use ‘AppTabs.SelectedIndex() int‘ instead. 


func (*“AppTabs) ExtendBase Widget 


func (t *AppTabs) ExtendBaseWidget (wid fyne.Widget) 
ExtendBaseWidget is used by an extending widget to make use of Base Widget functionality. 


Deprecated: Support for extending containers is being removed 


func (*“AppTabs) Hide 


func (t *AppTabs) Hide () 
Hide hides the widget. 


Implements: fyne.CanvasObject 
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func (*AppTabs) MinSize 


func (t *AppTabs) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below 


Implements: fyne.CanvasObject 


func (*“AppTabs) Remove 


func (t *AppTabs) Remove(item *TabItem) 


Remove tab by value. 


func (*AppTabs) RemovelIndex 


func (t *AppTabs) RemoveIndex(index int) 
RemovelIndex removes tab by index. 

func (*“AppTabs) Select 

func (t *AppTabs) Select (item *TabItem) 


Select sets the specified TabItem to be selected and its content visible. 


func (*AppTabs) SelectIndex 


func (t *AppTabs) SelectIndex(index int) 


SelectIndex sets the TabItem at the specific index to be selected and its content visible. 


func (*“AppTabs) SelectTab 


func (t *AppTabs) SelectTab(item *TabItem) 
SelectTab sets the specified TabItem to be selected and its content visible. 


Deprecated: Use ‘AppTabs.Select(*TabItem)‘ instead. 


func (*AppTabs) SelectTabIndex 


func (t *AppTabs) SelectTabIndex (index int) 
SelectTabIndex sets the TabItem at the specific index to be selected and its content visible. 


Deprecated: Use ‘AppTabs.SelectIndex(int)‘ instead. 
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func (*“AppTabs) Selected 


func (t *AppTabs) Selected() *TabItem 

Selected returns the currently selected TabItem. 

func (*AppTabs) SelectedIndex 

func (t *AppTabs) SelectedIndex() int 
SelectedIndex returns the index of the currently selected TabItem. 
func (*AppTabs) SetItems 

func (t *AppTabs) SetItems(items []*TabItem) 
SetItems sets the containers items and refreshes. 

func (*AppTabs) SetTabLocation 

func (t *AppTabs) SetTabLocation(l TabLocation) 
SetTabLocation sets the location of the tab bar 

func (*AppTabs) Show 

func (t *AppTabs) Show() 

Show this widget, if it was previously hidden 


Implements: fyne.CanvasObject 
Tags: 
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Fyne API "container.DocTabs"' 


container.DocTabs 


import "fyne.io/fyne/v2/container" 


Usage 
type DocTabs 


type DocTabs struct { 
widget .BaseWidget 


Items []*TabItem 


CreateTab func() *TabItem 
CloseIntercept func (*TabItem) 
OnClosed func (*TabItem) 
OnSelected func (*TabItem) 
OnUnselected func (*TabItem) 


} 


DocTabs container is used to display various pieces of content identified by tabs. The tabs contain text 
and/or an icon and allow the user to switch between the content specified in each TabItem. Each item is 
represented by a button at the edge of the container. 


Since: 2.1 


func NewDocTabs 


func NewDocTabs (items ...*TabItem) *DocTabs 
NewDocTabs creates a new tab container that allows the user to choose between various pieces of content. 


Since: 2.1 
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func (*DocTabs) Append 


func (t *DocTabs) Append(item *TabItem) 


Append adds a new TablItem to the end of the tab bar. 


func (*DocTabs) CreateRenderer 


func (t *DocTabs) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
Implements: fyne.Widget 

func (*DocTabs) Hide 

func (t *DocTabs) Hide () 

Hide hides the widget. 


Implements: fyne.CanvasObject 


func (*DocTabs) MinSize 


func (t *DocTabs) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below 


Implements: fyne.CanvasObject 


func (*DocTabs) Remove 


func (t *DocTabs) Remove(item *TabItem) 


Remove tab by value. 


func (*DocTabs) RemovelIndex 


func (t *DocTabs) RemoveIndex (index int) 


Removelndex removes tab by index. 


func (*DocTabs) Select 


func (t *DocTabs) Select (item *TabItem) 


Select sets the specified TabItem to be selected and its content visible. 
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func (*DocTabs) SelectIndex 


func (t *DocTabs) SelectIndex(index int) 


SelectIndex sets the TabItem at the specific index to be selected and its content visible. 
func (*DocTabs) Selected 
func (t *DocTabs) Selected() *TabItem 


Selected returns the currently selected TabItem. 


func (*DocTabs) SelectedIndex 


func (t *DocTabs) SelectedIndex() int 


SelectedIndex returns the index of the currently selected TabItem. 


func (*DocTabs) SetItems 


func (t *DocTabs) SetItems(items []*TabItem) 
SetItems sets the containers items and refreshes. 

func (*DocTabs) SetTabLocation 

func (t *DocTabs) SetTabLocation(l TabLocation) 
SetTabLocation sets the location of the tab bar 

func (*DocTabs) Show 

func (t *DocTabs) Show() 

Show this widget, if it was previously hidden 


Implements: fyne.CanvasObject 
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Fyne API "container.Scroll"' 


container.Scroll 


import "fyne.io/fyne/v2/container" 


Usage 
type Scroll 
type Scroll = widget.Scroll 


Scroll defines a container that is smaller than the Content. The Offset is used to determine the position of 
the child widgets within the container. 


Since: 1.4 


func NewHScroll 


func NewHScroll(content fyne.CanvasObject) *Scroll 


NewHScroll create a scrollable parent wrapping the specified content. Note that this may cause the 
MinSize.Width to be smaller than that of the passed object. 


Since: 1.4 


func NewScroll 


func NewScroll(content fyne.CanvasObject) *Scroll 


NewScroll creates a scrollable parent wrapping the specified content. Note that this may cause the 
MinSize to be smaller than that of the passed object. 


Since: 1.4 
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func NewVScroll 


func NewVScroll(content fyne.CanvasObject) *Scroll 


NewV/Scroll a scrollable parent wrapping the specified content. Note that this may cause the 
MinSize.Height to be smaller than that of the passed object. 


Since: 1.4 
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Fyne API "container.ScrollDirection" 


container.ScrollDirection 


import "fyne.io/fyne/v2/container" 


Usage 


type ScrollDirection 


type ScrollDirection = widget.ScrollDirection 


ScrollDirection represents the directions in which a Scroll container can scroll its child content. 
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Fyne API "container.Split"' 


container.Split 


import "fyne.io/fyne/v2/container" 


Usage 
type Split 


type Split struct { 
widget .BaseWidget 


Offset float64 
Horizontal bool 

Leading fyne.CanvasObject 
Trailing fyne.CanvasObject 


} 
Split defines a container whose size is split between two children. 


Since: 1.4 


func NewHSplit 


func NewHSplit (leading, trailing fyne.CanvasObject) *Split 


NewHSplit creates a horizontally arranged container with the specified leading and trailing elements. A 
vertical split bar that can be dragged will be added between the elements. 


Since: 1.4 


func NewVSplit 


func NewVSplit (top, bottom fyne.CanvasObject) *Split 


NewVSplit creates a vertically arranged container with the specified top and bottom elements. A 
horizontal split bar that can be dragged will be added between the elements. 


Since: 1.4 
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func (*Split) CreateRenderer 


func (s *Split) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 

func (*Split) ExtendBase Widget 

func (s *Split) ExtendBaseWidget (wid fyne.Widget) 

ExtendBaseWidget is used by an extending widget to make use of Base Widget functionality. 
Deprecated: Support for extending containers is being removed 


func (*Split) SetOffset 


func (s *Split) SetOffset (offset float64) 


SetOffset sets the offset (0.0 to 1.0) of the Split divider. 0.0 - Leading is min size, Trailing uses all 
remaining space. 0.5 - Leading & Trailing equally share the available space. 1.0 - Trailing is min size, 
Leading uses all remaining space. 
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Fyne API "container.TabItem" 


container. TabItem 


import "fyne.io/fyne/v2/container" 


Usage 


type TabItem 
type TabItem struct { 
Text string 
Icon fyne.Resource 


Content fyne.CanvasObject 
} 


TablItem represents a single view in a tab view. The Text and Icon are used for the tab button and the 
Content is shown when the corresponding tab is active. 


Since: 1.4 
func NewTabItem 
func NewTabItem(text string, content fyne.CanvasObject) *TabItem 


NewTabltem creates a new item for a tabbed widget - each item specifies the content and a label for its 
tab. 


Since: 1.4 


func NewTabItemWithIcon 


func NewTabItemWithIcon(text string, icon fyne.Resource, content fyne.CanvasObject) *TabItem 


NewTabItemWithIcon creates a new item for a tabbed widget - each item specifies the content and a label 
with an icon for its tab. 


Since: 1.4 
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Fyne API "binding.Bool"' 


binding.Bool 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type Bool 


type Bool interface { 
DataItem 
Get() (bool, error) 


Set (bool) error 


} 
Bool supports binding a bool value. 


Since: 2.0 


func BindPreferenceBool 


func BindPreferenceBool (key string, p fyne.Preferences) Bool 


BindPreferenceBool returns a bindable bool value that is managed by the application preferences. Changes 
to this value will be saved to application storage and when the app starts the previous values will be read. 


Since: 2.0 


func NewBool 


func NewBool() Bool 
NewBool returns a bindable bool value that is managed internally. 


Since: 2.0 
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func StringToBool 


func StringToBool(str String) Bool 


StringToBool creates a binding that connects a String data item to a Bool. Changes to the String will be 
parsed and pushed to the Bool if the parse was successful, and setting the Bool update the String binding. 


Since: 2.0 
func StringToBoolWithFormat 
func StringToBoolWithFormat (str String, format string) Bool 


StringToBoolWithFormat creates a binding that connects a String data item to a Bool and is presented 
using the specified format. Changes to the Bool will be parsed and if the format matches and the parse is 
successful it will be pushed to the String. Setting the Bool will push a formatted value into the String. 


Since: 2.0 
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binding.BoolList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type BoolList 


type BoolList interface { 
DataList 


Append(value bool) error 

Get () ([]bool, error) 

GetValue (index int) (bool, error) 
Prepend(value bool) error 

Set (list []bool) error 

SetValue (index int, value bool) error 


} 
BoolList supports binding a list of bool values. 


Since: 2.0 


func NewBoolList 
func NewBoolList() BoolList 


NewBoolList returns a bindable list of bool values. 
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Fyne API "binding.Bytes" 


binding.Bytes 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Bytes 

type Bytes interface { 
DataItem 
Get () ([]byte, error) 


Set ([]byte) error 
} 


Bytes supports binding a []byte value. 


Since: 2.2 


func NewBytes 
func NewBytes() Bytes 


NewByftes returns a bindable []byte value that is managed internally. 
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binding.BytesList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type BytesList 


type BytesList interface { 
DataList 


Append(value []byte) error 

Get () ([][]byte, error) 

GetValue (index int) ([]byte, error) 
Prepend(value []byte) error 

Set (list [][]byte) error 

SetValue (index int, value []byte) error 


} 
BytesList supports binding a list of []byte values. 


Since: 2.2 


func NewBytesList 
func NewBytesList() BytesList 


NewBytesList returns a bindable list of []byte values. 
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binding.DataItem 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Dataltem 


type DataItem interface { 
// AddListener attaches a new change listener to this DataItem. 
// Listeners are called each time the data inside this DataItem changes. 
// Additionally the listener will be triggered upon successful connection to get the current value. 
AddListener (DataListener) 
// RemoveListener will detach the specified change listener from the DataItem. 
// Disconnected listener will no longer be triggered when changes occur. 
RemoveListener (DataListener) 


Dataltem is the base interface for all bindable data items. 
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Fyne API "binding.DataList"' 


binding.DataList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type DataList 

type DataList interface { 
DataItem 
GetItem(index int) (DatalItem, error) 
Length() int 

} 


DataList is the base interface for all bindable data lists. 
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Fyne API "binding.DataListener"' 


binding.DataListener 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type DataListener 


type DataListener interface { 
DataChanged () 


} 


DataListener is any object that can register for changes in a bindable Dataltem. See NewDataListener to 
define a new listener using just an inline function. 


Since: 2.0 


func NewDataListener 
func NewDataListener(fn func()) DataListener 


NewDataListener is a helper function that creates a new listener type from a simple callback function. 
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Fyne API ''binding.DataMap" 


binding.DataMap 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type DataMap 


type DataMap interface { 
DataItem 
GetItem(string) (DataItem, error) 


Keys() []string 
} 


DataMap is the base interface for all bindable data maps. 
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binding.ExternalBool 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalBool 


type ExternalBool interface { 
Bool 
Reload() error 
} 
ExternalBool supports binding a bool value to an external value. 


Since: 2.0 


func BindBool 


func BindBool(v *bool) ExternalBool 


BindBool returns a new bindable value that controls the contents of the provided bool variable. If your 
code changes the content of the variable this refers to you should call Reload() to inform the bindings. 
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binding.ExternalBoolList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalBoolList 


type ExternalBoolList interface { 
BoolList 


Reload() error 


} 
ExternalBoolList supports binding a list of bool values from an external variable. 


Since: 2.0 


func BindBoolList 


func BindBoolList(v *[]bool) ExternalBoolList 


BindBoolList returns a bound list of bool values, based on the contents of the passed slice. If your code 
changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalBytes 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalBytes 


type ExternalBytes interface { 
Bytes 
Reload() error 
} 
ExternalBytes supports binding a []byte value to an external value. 


Since: 2.2 


func BindBytes 


func BindBytes(v *[]byte) ExternalBytes 


BindBytes returns a new bindable value that controls the contents of the provided []byte variable. If your 
code changes the content of the variable this refers to you should call Reload() to inform the bindings. 
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binding.ExternalBytesList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalBytesList 


type ExternalBytesList interface { 
BytesList 


Reload() error 


} 

ExternalBytesList supports binding a list of []byte values from an external variable. 
Since: 2.2 

func BindBytesList 

func BindBytesList (v *[][]byte) ExternalBytesList 


BindBytesList returns a bound list of []byte values, based on the contents of the passed slice. If your code 
changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalFloat 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalFloat 


type ExternalFloat interface { 
Float 
Reload() error 
} 
ExternalFloat supports binding a float64 value to an external value. 
Since: 2.0 
func BindFloat 


func BindFloat(v *float64) ExternalFloat 


BindFloat returns a new bindable value that controls the contents of the provided float64 variable. If your 
code changes the content of the variable this refers to you should call Reload() to inform the bindings. 
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binding.ExternalFloatList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalFloatList 


type ExternalFloatList interface { 
FloatList 


Reload() error 


} 
ExternalFloatList supports binding a list of float64 values from an external variable. 


Since: 2.0 


func BindFloatList 


func BindFloatList(v *[]float64) ExternalFloatList 


BindFloatList returns a bound list of float64 values, based on the contents of the passed slice. If your code 
changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalInt 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalInt 


type ExternalInt interface { 
Int 
Reload() error 
} 
ExternalInt supports binding a int value to an external value. 


Since: 2.0 


func BindInt 


func BindInt(v *int) ExternalInt 


BindInt returns a new bindable value that controls the contents of the provided int variable. If your code 
changes the content of the variable this refers to you should call Reload() to inform the bindings. 
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binding.ExternalIntList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalIntList 


type ExternalIntList interface { 
IntList 


Reload() error 


} 
ExternalIntList supports binding a list of int values from an external variable. 


Since: 2.0 


func BindIntList 


func BindIntList(v *[]Jint) ExternalIntList 


BindIntList returns a bound list of int values, based on the contents of the passed slice. If your code 
changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalRune 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalRune 


type ExternalRune interface { 
Rune 
Reload() error 


} 
ExternalRune supports binding a rune value to an external value. 


Since: 2.0 


func BindRune 


func BindRune(v *rune) ExternalRune 


BindRune returns a new bindable value that controls the contents of the provided rune variable. If your 
code changes the content of the variable this refers to you should call Reload() to inform the bindings. 
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binding.ExternalRuneList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalRuneList 


type ExternalRuneList interface { 
RuneList 


Reload() error 


} 
ExternalRuneList supports binding a list of rune values from an external variable. 


Since: 2.0 


func BindRuneList 


func BindRuneList(v *[]rune) ExternalRuneList 


BindRuneList returns a bound list of rune values, based on the contents of the passed slice. If your code 
changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalString 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalString 


type ExternalString interface { 
String 
Reload() error 
} 
ExternalString supports binding a string value to an external value. 


Since: 2.0 


func BindString 


func BindString(v *string) ExternalString 


BindString returns a new bindable value that controls the contents of the provided string variable. If your 
code changes the content of the variable this refers to you should call Reload() to inform the bindings. 
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binding.ExternalStringList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalStringList 


type ExternalStringList interface { 
StringList 


Reload() error 


} 
ExternalStringList supports binding a list of string values from an external variable. 


Since: 2.0 


func BindStringList 


func BindStringList(v *[]string) ExternalStringList 


BindStringList returns a bound list of string values, based on the contents of the passed slice. If your code 
changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalUntyped 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalUntyped 


type ExternalUntyped interface { 
Untyped 
Reload() error 
} 
ExternalUntyped supports binding a interface{} value to an external value. 


Since: 2.1 


func BindUntyped 


func BindUntyped(v interface{}) ExternalUntyped 


BindUntyped returns a bindable interface{ } value that is bound to an external type. The parameter must be 
a pointer to the type you wish to bind. 


Since: 2.1 
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binding.ExternalUntypedList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type ExternalUntypedList 


type ExternalUntypedList interface { 
UntypedList 


Reload() error 


} 
ExternalUntypedList supports binding a list of interface{ } values from an external variable. 


Since: 2.1 


func BindUntypedList 


func BindUntypedList(v *[Jinterface{}) ExternalUntypedList 


BindUntypedList returns a bound list of interface{ } values, based on the contents of the passed slice. If 
your code changes the content of the slice this refers to you should call Reload() to inform the bindings. 
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binding.ExternalUntypedMap 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type ExternalUntypedMap 


type ExternalUntypedMap interface { 
Unt ypedMap 
Reload() error 


} 


ExternalUntypedMap is a map data binding with all values untyped (interface {}), connected to an external 
data source. 


Since: 2.0 


func BindUntypedMap 


func BindUntypedMap(d *map[string]interface{}) ExternalUntypedMap 


BindUntypedMap creates a new map binding of string to interface{ } based on the data passed. If your 
code changes the content of the map this refers to you should call Reload() to inform the bindings. 
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binding.ExternalURI 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type ExternalURI 


type ExternalURI interface { 
URI 
Reload() error 
} 
ExternalURI supports binding a fyne.URI value to an external value. 
Since: 2.1 
func BindURI 


func BindURI(v *fyne.URI) ExternalURI 


BindURI returns a new bindable value that controls the contents of the provided fyne.URI variable. If your 
code changes the content of the variable this refers to you should call Reload() to inform the bindings. 


Since: 2.1 
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binding.ExternalURIList 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type ExternalURIList 


type ExternalURIList interface { 
URIList 


Reload() error 


} 
ExternalURIList supports binding a list of fyne.URI values from an external variable. 


Since: 2.1 


func BindURIList 


func BindURIList(v *[]fyne.URI) ExternalURIList 


BindURIList returns a bound list of fyne.URI values, based on the contents of the passed slice. If your 
code changes the content of the slice this refers to you should call Reload() to inform the bindings. 


Since: 2.1 
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binding.Float 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Float 


type Float interface { 
DataItem 
Get () (float64, error) 
Set (float64) error 
} 
Float supports binding a float64 value. 
Since: 2.0 
func BindPreferenceFloat 


func BindPreferenceFloat (key string, p fyne.Preferences) Float 


BindPreferenceFloat returns a bindable float64 value that is managed by the application preferences. 
Changes to this value will be saved to application storage and when the app starts the previous values will 
be read. 


Since: 2.0 


func NewFloat 


func NewFloat() Float 
NewFloat returns a bindable float64 value that is managed internally. 


Since: 2.0 
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func StringToFloat 


func StringToFloat (str String) Float 


StringToFloat creates a binding that connects a String data item to a Float. Changes to the String will be 
parsed and pushed to the Float if the parse was successful, and setting the Float update the String binding. 


Since: 2.0 
func StringToFloatWithFormat 
func StringToFloatWithFormat (str String, format string) Float 


StringToFloatWithFormat creates a binding that connects a String data item to a Float and is presented 
using the specified format. Changes to the Float will be parsed and if the format matches and the parse is 
successful it will be pushed to the String. Setting the Float will push a formatted value into the String. 


Since: 2.0 
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Fyne API "binding.FloatList" 


binding.FloatList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type FloatList 


type FloatList interface { 
DataList 


Append(value float64) error 

Get () ([]float64, error) 

GetValue (index int) (float64, error) 
Prepend(value float64) error 

Set (list []float64) error 

SetValue (index int, value float64) error 


} 
FloatList supports binding a list of float64 values. 


Since: 2.0 


func NewFloatList 
func NewFloatList() FloatList 


NewFloatList returns a bindable list of float64 values. 
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Fyne API "binding.Int" 


binding.Int 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Int 

type Int interface { 
DataItem 
Get() (int, error) 


Set (int) error 


} 
Int supports binding a int value. 


Since: 2.0 


func BindPreferenceInt 


func BindPreferencelInt (key string, p fyne.Preferences) 


BindPreferencelInt returns a bindable int value that is managed by the application preferences. Changes to 
this value will be saved to application storage and when the app starts the previous values will be read. 


Since: 2.0 


func NewInt 


func NewInt() Int 


NewInt returns a bindable int value that is managed internally. 


Since: 2.0 


func StringToInt 


func StringToInt(str String) Int 


StringToInt creates a binding that connects a String data item to a Int. Changes to the String will be parsed 
and pushed to the Int if the parse was successful, and setting the Int update the String binding. 


Since: 2.0 
func StringToIntWithFormat 
func StringToIntWithFormat (str String, format string) Int 


StringToIntWithFormat creates a binding that connects a String data item to a Int and is presented using 
the specified format. Changes to the Int will be parsed and if the format matches and the parse is 
successful it will be pushed to the String. Setting the Int will push a formatted value into the String. 


Since: 2.0 
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Fyne API "binding.IntList" 


binding.IntList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type IntList 


type IntList interface { 
DataList 


Append(value int) error 
Get () ([]int, error) 


GetValue (index int) (int, error) 


Prepend(value int) error 
Set (list []int) error 
SetValue (index int, value int) 


} 
IntList supports binding a list of int values. 


Since: 2.0 


func NewIntList 


func NewIntList() IntList 


NewlIntList returns a bindable list of int values. 
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Fyne API "binding.Rune"' 


binding.Rune 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Rune 

type Rune interface { 
DataItem 
Get () (rune, error) 


Set (rune) error 


} 
Rune supports binding a rune value. 


Since: 2.0 


func NewRune 
func NewRune() Rune 


NewRune returns a bindable rune value that is managed internally. 
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Fyne API "binding.RuneList"' 


binding.RuneList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type RuneList 


type RuneList interface { 
DataList 


Append(value rune) error 

Get () ([]rune, error) 

GetValue (index int) (rune, error) 
Prepend(value rune) error 

Set (list []rune) error 

SetValue (index int, value rune) error 


} 
RuneList supports binding a list of rune values. 


Since: 2.0 


func NewRuneList 
func NewRuneList() RuneList 


NewRuneList returns a bindable list of rune values. 


Since: 2.0 
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Fyne API ''binding.String"' 


binding.String 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type String 

type String interface { 
DataItem 
Get () (string, error) 
Set (string) error 

} 

String supports binding a string value. 

Since: 2.0 

func BindPreferenceString 


func BindPreferenceString(key string, p fyne.Preferences) String 


BindPreferenceString returns a bindable string value that is managed by the application preferences. 
Changes to this value will be saved to application storage and when the app starts the previous values will 
be read. 


Since: 2.0 


func BoolToString 


func BoolToString(v Bool) String 


BoolToString creates a binding that connects a Bool data item to a String. Changes to the Bool will be 
pushed to the String and setting the string will parse and set the Bool if the parse was successful. 


Since: 2.0 
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func BoolToStringWithFormat 


func BoolToStringWithFormat (v Bool, format string) String 


BoolToStringWithFormat creates a binding that connects a Bool data item to a String and is presented 
using the specified format. Changes to the Bool will be pushed to the String and setting the string will 
parse and set the Bool if the string matches the format and its parse was successful. 


Since: 2.0 
func FloatToString 
func FloatToString(v Float) String 


FloatToString creates a binding that connects a Float data item to a String. Changes to the Float will be 
pushed to the String and setting the string will parse and set the Float if the parse was successful. 


Since: 2.0 
func FloatToStringWithFormat 
func FloatToStringWithFormat (v Float, format string) String 


FloatToString WithFormat creates a binding that connects a Float data item to a String and is presented 
using the specified format. Changes to the Float will be pushed to the String and setting the string will 
parse and set the Float if the string matches the format and its parse was successful. 


Since: 2.0 
func IntToString 
func IntToString(v Int) String 


IntToString creates a binding that connects a Int data item to a String. Changes to the Int will be pushed to 
the String and setting the string will parse and set the Int if the parse was successful. 


Since: 2.0 
func IntToStringWithFormat 
func IntToStringWithFormat (v Int, format string) String 


IntToStringWithFormat creates a binding that connects a Int data item to a String and is presented using 
the specified format. Changes to the Int will be pushed to the String and setting the string will parse and 
set the Int if the string matches the format and its parse was successful. 


Since: 2.0 
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func NewSprintf 


func NewSprintf(format string, b ...DataItem) String 


NewSprintf returns a String binding that format its content using the format string and the provide 
additional parameter that must be other data bindings. This data binding use fmt.Sprintf and fmt.Scanf 
internally and will have all the same limitation as those function. 


Since: 2.2 

func NewString 

func NewString() String 

NewString returns a bindable string value that is managed internally. 

Since: 2.0 

func StringToStringWithFormat 

func StringToStringWithFormat (str String, format string) String 


StringToString WithFormat creates a binding that converts a string to another string using the specified 
format. Changes to the returned String will be pushed to the passed in String and setting a new string value 
will parse and set the underlying String if it matches the format and the parse was successful. 


Since: 2.2 


func URIToString 


func URIToString(v URI) String 


URIToString creates a binding that connects a URI data item to a String. Changes to the URI will be 
pushed to the String and setting the string will parse and set the URI if the parse was successful. 


Since: 2.1 
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If you like the Fyne toolkit please consider[sponsoring| [p ??] our work. 


3837 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


3838 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


3839 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


3840 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


3841 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


3842 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


3843 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


3844 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


3845 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My App][p 5023] 
Fyne API "binding.StringList" 


binding.StringList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type StringList 


type StringList interface { 
DataList 


Append(value string) error 

Get () ([]string, error) 

GetValue (index int) (string, error) 
Prepend(value string) error 

Set (list []string) error 

SetValue (index int, value string) error 


} 
StringList supports binding a list of string values. 


Since: 2.0 


func NewStringList 
func NewStringList() StringList 


NewStringList returns a bindable list of string values. 
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binding.Struct 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Struct 

type Struct interface { 
DataMap 
GetValue(string) (interface{}, error) 
SetValue(string, interface{}) error 


Reload() error 


} 
Struct is the base interface for a bound struct type. 


Since: 2.0 


func BindStruct 


func BindStruct(i interface{}) Struct 


BindStruct creates a new map binding of string to interface{ } using the struct passed as data. The key for 
each item is a string representation of each exported field with the value set as an interface{ }. Only 


exported fields are included. 
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binding.Untyped 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type Untyped 

type Untyped interface { 
DataItem 
Get () (interface{}, error) 
Set (interface{}) rror 


} 
Untyped supports binding a interface{} value. 


Since: 2.1 


func NewUntyped 
func NewUntyped() Untyped 


NewUntyped returns a bindable interface{ } value that is managed internally. 
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binding.UntypedList 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type UntypedList 
type UntypedList interface { 
DataList 
Append(value interface{}) rror 
Get () ([]Jinterface{}, error) 
GetValue (index int) (interface{}, error) 
Prepend(value interface{}) rror 
Set (list []Jinterface{}) error 
SetValue (index int, value interface{}) rror 


} 
UntypedList supports binding a list of interface{ } values. 


Since: 2.1 


func NewUntypedList 
func NewUntypedList() UntypedList 


NewUntypedList returns a bindable list of interface{ } values. 
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binding.UntypedMap 


import "fyne.io/fyne/v2/data/binding" 


Usage 


type UntypedMap 

type UntypedMap interface { 
DataMap 
Delete (string) 
Get () (map[string]interface{}, error) 
GetValue(string) (interface{}, error) 
Set (map[string]interface{}) error 
SetValue(string, interface{}) error 


} 
UntypedMap is a map data binding with all values Untyped (interface { }). 


Since: 2.0 


func NewUntypedMap 
func NewUntypedMap() UntypedMap 


NewUntypedMap creates a new, empty map binding of string to interface{ }. 
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Fyne API "binding.URI" 


binding.URI 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type URI 


type URI interface { 
DataItem 
Get () (fyne.URI, error) 
Set (fyne.URI) error 


} 
URI supports binding a fyne.URI value. 


Since: 2.1 


func NewURI 

func NewURI() URI 

NewURI returns a bindable fyne.URI value that is managed internally. 
Since: 2.1 

func StringToURI 

func StringToURI(str String) URI 


StringToURI creates a binding that connects a String data item to a URI. Changes to the String will be 
parsed and pushed to the URI if the parse was successful, and setting the URI update the String binding. 


Since: 2.1 
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binding.URIList 


import "fyne.io/fyne/v2/data/binding" 


Usage 
type URIList 


type URIList interface { 
DataList 


Append(value fyne.URI) error 

Get () ([]fyne.URI, error) 

GetValue (index int) (fyne.URI, error) 
Prepend(value fyne.URI) error 

Set (list []fyne.URI) error 

SetValue (index int, value fyne.URI) error 


} 
URIList supports binding a list of fyne.URI values. 


Since: 2.1 


func NewURIList 
func NewURIList() URIList 


NewURIList returns a bindable list of fyne.URI values. 
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Fyne API "validation" 


validation 


import "fyne.io/fyne/v2/data/validation" 


Package validation provides validation for data inside widgets. 


Usage 
func NewAllStrings 
func NewAllStrings (validators ...fyne.StringValidator) fyne.StringValidator 


NewAllStrings creates a validator that requires all of the passed string validators to pass. In short, it 
combines multiple string validators into one. 


Since: 2.2 
func NewRegexp 
func NewRegexp(regexpstr, reason string) fyne.StringValidator 


NewRegexp creates a new validator that uses regular expression parsing. The validator will return nil if 
valid, otherwise returns an error with a reason text. 


Since: 1.4 
func NewTime 
func NewTime (format string) fyne.StringValidator 


NewTime creates a new validator that verifies times using time.Parse. The validator will return nil if valid, 
otherwise returns an error with a reason text. The reference time for the format: Mon Jan 2 15:04:05 -0700 
MST 2006. See time.Parse() for more information about the reference time: https://pkg.go.dev/time#Parse 


Since: 2.1 
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Fyne API "dialog" 


dialog 


import "fyne.io/fyne/v2/dialog" 


Package dialog defines standard dialog windows for application GUIs. 


Usage 

func ShowColorPicker 

func ShowColorPicker(title, message string, callback func(c color.Color), parent fyne.Window) 
ShowColorPicker creates and shows a color dialog. The callback is triggered when the user selects a color. 
Since: 1.4 

func ShowConfirm 

func ShowConfirm(title, message string, callback func(bool), parent fyne.Window) 


ShowConfirm shows a dialog over the specified window for a user confirmation. The title is used for the 
dialog window and message is the content. The callback is executed when the user decides. 


func ShowCustom 
func ShowCustom(title, dismiss string, content fyne.CanvasObject, parent fyne.Window) 


ShowCustom shows a dialog over the specified application using custom content. The button will have the 
dismiss text set. The MinSize() of the CanvasObject passed will be used to set the size of the window. 


func ShowCustomConfirm 


func ShowCustomConfirm(title, confirm, dismiss string, content fyne.CanvasObject, 
callback func(bool), parent fyne.Window) 


ShowCustomConfirm shows a dialog over the specified application using custom content. The cancel 
button will have the dismiss text set and the 4OK4 will use the confirm text. The response callback is 
called on user action. The MinSize() of the CanvasObject passed will be used to set the size of the 
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window. 


func ShowEntryDialog 


func ShowEntryDialog(title, message string, onConfirm func(string), parent fyne.Window) 
ShowEntryDialog creates a new entry dialog and shows it immediately. 


Deprecated: Use dialog.ShowFormDialog() with a widget.Entry inside instead. 


func ShowError 


func ShowError(err error, parent fyne.Window) 


ShowError shows a dialog over the specified window for an application error. The message is extracted 
from the provided error (should not be nil). 


func ShowFileOpen 


func ShowFileOpen(callback func(fyne.URIReadCloser, error), parent fyne.Window) 


ShowFileOpen creates and shows a file dialog allowing the user to choose a file to open. The callback 
function will run when the dialog closes. The URI will be nil when the user cancels or when nothing is 
selected. 


The dialog will appear over the window specified. 
func ShowFileSave 
func ShowFileSave (callback func(fyne.URIWriteCloser, error), parent fyne.Window) 


ShowFileSave creates and shows a file dialog allowing the user to choose a file to save to (new or 
overwrite). If the user chooses an existing file they will be asked if they are sure. The callback function 
will run when the dialog closes. The URI will be nil when the user cancels or when nothing is selected. 


The dialog will appear over the window specified. 


func ShowFolderOpen 


func ShowFolderOpen (callback func(fyne.ListableURI, error), parent fyne.Window) 


ShowFolderOpen creates and shows a file dialog allowing the user to choose a folder to open. The 
callback function will run when the dialog closes. The URI will be nil when the user cancels or when 
nothing is selected. 


The dialog will appear over the window specified. 


Since: 1.4 


3921 


func ShowForm 


func ShowForm(title, confirm, dismiss string, content []*widget.FormItem, callback func(bool), parent fyne.Window) 


ShowForm shows a dialog over the specified application using the provided FormItems. The cancel button 
will have the dismiss text set and the confirm button will use the confirm text. The response callback is 
called on user action after validation passes. If any Validatable widget reports that validation has failed, 
then the confirm button will be disabled. The initial state of the confirm button will reflect the initial 
validation state of the items added to the form dialog. The MinSize() of the CanvasObject passed will be 
used to set the size of the window. 


Since: 2.0 


func ShowInformation 


func ShowInformation(title, message string, parent fyne.Window) 


ShowInformation shows a dialog over the specified window for user information. The title is used for the 
dialog window and message is the content. 
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Fyne API "dialog.ColorPickerDialog"' 


dialog.ColorPickerDialog 


import "fyne.io/fyne/v2/dialog" 


Usage 
type ColorPickerDialog 


type ColorPickerDialog struct { 
Advanced bool 
} 


ColorPickerDialog is a simple dialog window that displays a color picker. 


Since: 1.4 


func NewColorPicker 


func NewColorPicker (title, message string, callback func(c color.Color), parent fyne.Window) *ColorPickerDialog 


NewColorPicker creates a color dialog and returns the handle. Using the returned type you should call 
Show() and then set its color through SetColor(). The callback is triggered when the user selects a color. 


Since: 1.4 


func (ColorPickerDialog) Hide 


func (d ColorPickerDialog) Hide () 


func (ColorPickerDialog) MinSize 


func (d ColorPickerDialog) MinSize() fyne.Size 
MinSize returns the size that this dialog should not shrink below 


Since: 2.1 
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func (*ColorPickerDialog) Refresh 


func (p *ColorPickerDialog) Refresh () 


Refresh causes this dialog to be updated 


func (ColorPickerDialog) Resize 


func (d ColorPickerDialog) Resize(size fyne.Size) 


Resize dialog, call this function after dialog show 

func (*ColorPickerDialog) SetColor 

func (p *ColorPickerDialog) SetColor(c color.Color) 
SetColor updates the color of the color picker. 

func (ColorPickerDialog) SetDismissText 

func (d ColorPickerDialog) SetDismissText (label string) 
SetDismissText allows custom text to be set in the dismiss button 
func (ColorPickerDialog) SetOnClosed 

func (d ColorPickerDialog) SetOnClosed(closed func () ) 
SetOnClosed allows to set a callback function that is called when the dialog is closed 
func (*ColorPickerDialog) Show 

func (p *ColorPickerDialog) Show() 

Show causes this dialog to be displayed 
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dialog.ConfirmDialog 


import "fyne.io/fyne/v2/dialog" 


Usage 


type ConfirmDialog 


type ConfirmDialog struct { 
} 


ConfirmDialog is like the standard Dialog but with an additional confirmation button 


func NewConfirm 


func NewConfirm(title, message string, callback func(bool), parent fyne.Window) *ConfirmDialog 


NewConfirm creates a dialog over the specified window for user confirmation. The title is used for the 
dialog window and message is the content. The callback is executed when the user decides. After creation 
you should call Show(). 


func (ConfirmDialog) Hide 


func (d ConfirmDialog) Hide () 


func (ConfirmDialog) MinSize 
func (d ConfirmDialog) MinSize() fyne.Size 


MinSize returns the size that this dialog should not shrink below 


Since: 2.1 


3941 


func (ConfirmDialog) Refresh 


func (d ConfirmDialog) Refresh () 


func (ConfirmDialog) Resize 


func (d ConfirmDialog) Resize(size fyne.Size) 


Resize dialog, call this function after dialog show 

func (*ConfirmDialog) SetConfirmText 

func (d *ConfirmDialog) SetConfirmText (label string) 

SetConfirmText allows custom text to be set in the confirmation button 

func (ConfirmDialog) SetDismissText 

func (d ConfirmDialog) SetDismissText (label string) 

SetDismissText allows custom text to be set in the dismiss button 

func (ConfirmDialog) SetOnClosed 

func (d ConfirmDialog) SetOnClosed(closed func() ) 

SetOnClosed allows to set a callback function that is called when the dialog is closed 


func (ConfirmDialog) Show 


func (d ConfirmDialog) Show() 
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Fyne API "dialog.Dialog"' 


dialog.Dialog 


import "fyne.io/fyne/v2/dialog" 


Usage 
type Dialog 


type Dialog interface { 

Show () 
Hide () 
SetDismissText (label string) 
SetOnClosed(closed func() ) 
Refresh () 
Resize(size fyne.Size) 


// Since: 2.1 
MinSize() fyne.Size 


} 


Dialog is the common API for any dialog window with a single dismiss button 


func NewCustom 


func NewCustom(title, dismiss string, content fyne.CanvasObject, parent fyne.Window) Dialog 


NewCustom creates and returns a dialog over the specified application using custom content. The button 
will have the dismiss text set. The MinSize() of the CanvasObject passed will be used to set the size of the 
window. 


func NewCustomConfirm 


func NewCustomConfirm(title, confirm, dismiss string, content fyne.CanvasObject, 
callback func(bool), parent fyne.Window) Dialog 


NewCustomConfirm creates and returns a dialog over the specified application using custom content. The 
cancel button will have the dismiss text set and the 4AOK4 will use the confirm text. The response callback 
is called on user action. The MinSize() of the CanvasObject passed will be used to set the size of the 
window. 
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func NewError 


func NewError(err error, parent fyne.Window) Dialog 


NewError creates a dialog over the specified window for an application error. The message is extracted 
from the provided error (should not be nil). After creation you should call Show(). 


func NewForm 


func NewForm(title, confirm, dismiss string, items []*widget.FormItem, callback func(bool), parent fyne.Window) Dialog 


NewForm creates and returns a dialog over the specified application using the provided FormItems. The 
cancel button will have the dismiss text set and the confirm button will use the confirm text. The response 
callback is called on user action after validation passes. If any Validatable widget reports that validation 
has failed, then the confirm button will be disabled. The initial state of the confirm button will reflect the 
initial validation state of the items added to the form dialog. 


Since: 2.0 


func NewInformation 


func NewInformation(title, message string, parent fyne.Window) Dialog 


Newlnformation creates a dialog over the specified window for user information. The title is used for the 
dialog window and message is the content. After creation you should call Show(). 


Tags: 
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dialog.EntryDialog 


import "fyne.io/fyne/v2/dialog" 


Usage 
type EntryDialog 


type EntryDialog struct { 
} 


EntryDialog is a variation of a dialog which prompts the user to enter some text. 


Deprecated: Use dialog.NewFormDialog() or dialog. ShowFormDialog() with a widget.Entry inside 
instead. 


func NewEntryDialog 


func NewEntryDialog(title, message string, onConfirm func(string), parent fyne.Window) *EntryDialog 
NewEntryDialog creates a dialog over the specified window for the user to enter a value. 


onConfirm is a callback that runs when the user enters a string of text and clicks the aconfirma button. 
May be nil. 


Deprecated: Use dialog.NewFormDialog() with a widget.Entry inside instead. 


func (*EntryDialog) SetOnClosed 


func (i *EntryDialog) SetOnClosed(callback func() ) 


SetOnClosed changes the callback which is run when the dialog is closed, which is nil by default. 
The callback is called unconditionally whether the user confirms or cancels. 


Note that the callback will be called after onConfirm, if both are non-nil. This way onConfirm can 
potential modify state that this callback needs to get the user input when the user confirms, while also 
being able to handle the case where the user cancelled. 
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func (*EntryDialog) SetPlaceholder 


func (i *EntryDialog) SetPlaceholder(s string) 


SetPlaceholder defines the placeholder text for the entry 


func (*EntryDialog) SetText 


func (i *EntryDialog) SetText(s string) 
SetText changes the current text value of the entry dialog, this can be useful for setting a default value. 
Tags: 
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Fyne API "dialog.FileDialog"' 


dialog.FileDialog 


import "fyne.io/fyne/v2/dialog" 


Usage 
type FileDialog 


type FileDialog struct { 
} 


FileDialog is a dialog containing a file picker for use in opening or saving files. 


func NewFileOpen 


func NewFileOpen (callback func(fyne.URIReadCloser, error), parent fyne.Window) *FileDialog 


NewFileOpen creates a file dialog allowing the user to choose a file to open. The callback function will 
run when the dialog closes. The URI will be nil when the user cancels or when nothing is selected. 


The dialog will appear over the window specified when Show() is called. 


func NewFileSave 


func NewFileSave(callback func(fyne.URIWriteCloser, error), parent fyne.Window) *FileDialog 


NewFileSave creates a file dialog allowing the user to choose a file to save to (new or overwrite). If the 
user chooses an existing file they will be asked if they are sure. The callback function will run when the 
dialog closes. The URI will be nil when the user cancels or when nothing is selected. 


The dialog will appear over the window specified when Show( is called. 


func NewFolderOpen 


func NewFolderOpen (callback func(fyne.ListableURI, error), parent fyne.Window) *FileDialog 
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NewFolderOpen creates a file dialog allowing the user to choose a folder to open. The callback function 
will run when the dialog closes. The URI will be nil when the user cancels or when nothing is selected. 


The dialog will appear over the window specified when Show() is called. 
Since: 1.4 

func (*FileDialog) Hide 

func (f *FileDialog) Hide() 

Hide hides the file dialog. 

func (*FileDialog) MinSize 

func (f *FileDialog) MinSize() fyne.Size 

MinSize returns the size that this dialog should not shrink below 


Since: 2.1 


func (*FileDialog) Refresh 
func (f *FileDialog) Refresh () 
Refresh causes this dialog to be updated 


func (*FileDialog) Resize 


func (f *FileDialog) Resize(size fyne.Size) 


Resize dialog to the requested size, if there is sufficient space. If the parent window is not large enough 
then the size will be reduced to fit. 


func (*FileDialog) SetConfirmText 

func (f *FileDialog) SetConfirmText (label string) 
SetConfirmText allows custom text to be set in the confirmation button 
Since: 2.2 

func (*FileDialog) SetDismissText 

func (f *FileDialog) SetDismissText (label string) 


SetDismissText allows custom text to be set in the dismiss button 
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func (*FileDialog) SetFileName 


func (f *FileDialog) SetFileName (fileName string) 


SetFileName sets the filename in a FileDialog in save mode. This is normally called before the dialog is 
shown. 


func (*FileDialog) SetFilter 


func (f *FileDialog) SetFilter(filter storage.FileFilter) 


SetFilter sets a filter for limiting files that can be chosen in the file dialog. 


func (*FileDialog) SetLocation 


func (f *FileDialog) SetLocation(u fyne.ListableURI) 


SetLocation tells this FileDirectory which location to display. This is normally called before the dialog is 
shown. 


Since: 1.4 


func (*FileDialog) SetOnClosed 


func (f *FileDialog) SetOnClosed(closed func() ) 


SetOnClosed sets a callback function that is called when the dialog is closed. 


func (*FileDialog) Show 


func (f *FileDialog) Show() 
Show shows the file dialog. 
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Fyne API ''dialog.ProgressDialog" 


dialog.ProgressDialog 


import "fyne.io/fyne/v2/dialog" 


Usage 


type ProgressDialog 


type ProgressDialog struct { 
} 


ProgressDialog is a simple dialog window that displays text and a progress bar. 


Deprecated: Create a new custom dialog with a widget.ProgressBar() inside. 


func NewProgress 


func NewProgress(title, message string, parent fyne.Window) *ProgressDialog 


NewProgress creates a progress dialog and returns the handle. Using the returned type you should call 
Show() and then set its value through SetValue(). 


Deprecated: Create a new custom dialog with a widget.ProgressBar() inside. 


func (ProgressDialog) Hide 


func (d ProgressDialog) Hide () 


func (ProgressDialog) MinSize 


func (d ProgressDialog) MinSize() fyne.Size 
MinSize returns the size that this dialog should not shrink below 


Since: 2.1 
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func (ProgressDialog) Refresh 


func (d ProgressDialog) Refresh () 


func (ProgressDialog) Resize 


func (d ProgressDialog) Resize(size fyne.Size) 


Resize dialog, call this function after dialog show 

func (ProgressDialog) SetDismissText 

func (d ProgressDialog) SetDismissText (label string) 

SetDismissText allows custom text to be set in the dismiss button 

func (ProgressDialog) SetOnClosed 

func (d ProgressDialog) SetOnClosed(closed func() ) 

SetOnClosed allows to set a callback function that is called when the dialog is closed 
func (*ProgressDialog) SetValue 

func (p *ProgressDialog) SetValue(v float64) 

SetValue updates the value of the progress bar - this should be between 0.0 and 1.0. 


func (ProgressDialog) Show 


func (d ProgressDialog) Show() 
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Fyne API "'dialog.ProgressInfiniteDialog" 


dialog.ProgressInfiniteDialog 


import "fyne.io/fyne/v2/dialog" 


Usage 


type ProgressInfiniteDialog 


type ProgressInfiniteDialog struct { 


} 
ProgressInfiniteDialog is a simple dialog window that displays text and a infinite progress bar. 


Deprecated: Create a new custom dialog with a widget.ProgressBarInfinite() inside. 


func NewProgressInfinite 


func NewProgressInfinite(title, message string, parent fyne.Window) *ProgressInfiniteDialog 


NewProgressInfinite creates a infinite progress dialog and returns the handle. Using the returned type you 
should call Show(). 


Deprecated: Create a new custom dialog with a widget.ProgressBarInfinite() inside. 


func (*ProgressInfiniteDialog) Hide 


func (d *ProgressInfiniteDialog) Hide() 


Hide this dialog and stop the infinite progress goroutine 


func (ProgressInfiniteDialog) MinSize 


func (d ProgressInfiniteDialog) MinSize() fyne.Size 
MinSize returns the size that this dialog should not shrink below 


Since: 2.1 


3992 


func (ProgressInfiniteDialog) Refresh 


func (d ProgressInfiniteDialog) Refresh () 


func (ProgressInfiniteDialog) Resize 


func (d ProgressInfiniteDialog) Resize(size fyne.Size) 


Resize dialog, call this function after dialog show 


func (ProgressInfiniteDialog) SetDismissText 

func (d ProgressInfiniteDialog) SetDismissText (label string) 
SetDismissText allows custom text to be set in the dismiss button 

func (ProgressInfiniteDialog) SetOnClosed 

func (d ProgressInfiniteDialog) SetOnClosed(closed func() ) 

SetOnClosed allows to set a callback function that is called when the dialog is closed 
func (ProgressInfiniteDialog) Show 

func (d ProgressInfiniteDialog) Show() 
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Fyne API "desktop" 


desktop 


import "fyne.io/fyne/v2/driver/desktop" 


Package desktop provides desktop specific driver functionality. 


Usage 


const ( 
// KeyNone represents no key 
KeyNone fyne.KeyName = "" 
// KeyShiftLeft represents the left shift key 
KeyShiftLeft fyne.KeyName = "LeftShift" 
// KeyShiftRight represents the right shift key 
eyShiftRight fyne.KeyName = "RightShift" 
// KeyControlLeft represents the left control key 
KeyControlLeft fyne.KeyName = "LeftControl" 
// KeyControlRight represents the right control key 
KeyControlRight fyne.KeyName = "RightControl" 
// KeyAltLeft represents the left alt key 
KeyAltLeft fyne.KeyName = "LeftAlt" 
// KeyAltRight represents the right alt key 
eyAltRight fyne.KeyName = "RightAlt" 
// KeySuperLeft represents the left "Windows" key (or "Command" key on macOS) 
eySuperLeft fyne.KeyName = "LeftSuper" 
// KeySuperRight represents the right "Windows" key (or "Command" key on macOS) 
KeySuperRight fyne.KeyName = "RightSuper" 
// KeyMenu represents the left or right menu / application key 
eyMenu fyne.KeyName = "Menu" 
// KeyPrintScreen represents the key used to cause a screen capture 
KeyPrintScreen fyne.KeyName = "PrintScreen" 


// KeyCapsLock represents the caps lock key, tapping once is the down event then again is the up 
KeyCapsLock fyne.KeyName = "CapsLock" 


const ( 
// ShiftModifier represents a shift key being held 
// 
// Deprecated: Use fyne.KeyModifierShift instead. 
ShiftModifier = fyne.KeyModifierShift 
// ControlModifier represents the ctrl key being held 
// 
// Deprecated: Use fyne.KeyModifierControl instead. 
ControlModifier = fyne.KeyModifierControl 
// AltModifier represents either alt keys being held 
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// 

// Deprecated: Use fyne.KeyModifierAlt instead. 
AltModifier = fyne.KeyModifierAlt 

// SuperModifier represents either super keys being held 
// 

// Deprecated: Use fyne.KeyModifierSuper instead. 
SuperModifier = fyne.KeyModifierSuper 
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Fyne API "desktop.App"' 


desktop.App 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type App 


type App interface { 
SetSystemTrayMenu(menu *fyne.Menu) 
SetSystemTrayIcon(icon fyne.Resource) 


} 
App defines the desktop specific extensions to a fyne.App. 
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import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type Canvas 


type Canvas interface { 
OnKeyDown() func (*fyne.KeyEvent) 
SetOnKeyDown (func (*fyne.KeyEvent) ) 
OnKeyUp() func (*fyne.KeyEvent) 
SetOnKeyUp (func (*fyne.KeyEvent) ) 


} 
Canvas defines the desktop specific extensions to a fyne.Canvas. 
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desktop.Cursor 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type Cursor 


type Cursor interface { 
// Image returns the image for the given cursor, or nil if none should be shown. 
// It also returns the x and y pixels that should act as the hot-spot (measured from top left corner). 
Image() (image.Image, int, int) 


} 
Cursor interface is used for objects that desire a specific cursor. 


Since: 2.0 
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desktop.Cursorable 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type Cursorable 


type Cursorable interface { 
Cursor() Cursor 


} 
Cursorable describes any CanvasObject that needs a cursor change 
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desktop.CustomShortcut 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type CustomShortcut 


type CustomShortcut struct { 
fyne.KeyName 
Modifier fyne.KeyModifier 
} 


CustomShortcut describes a shortcut desktop event. 

func (*CustomShortcut) Key 

func (cs *CustomShortcut) Key() fyne.KeyName 

Key returns the key name of this shortcut. @implements KeyboardShortcut 
func (*CustomShortcut) Mod 

func (cs *CustomShortcut) Mod() fyne.KeyModifier 

Mod returns the modifier of this shortcut. @implements KeyboardShortcut 
func (*CustomShortcut) ShortcutName 

func (cs *CustomShortcut) ShortcutName() string 

ShortcutName returns the shortcut name associated to the event 
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Fyne API "desktop.Driver" 


desktop.Driver 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type Driver 


type Driver interface { 
// Create a new borderless window that is centered on screen 
CreateSplashWindow() fyne.Window 


} 
Driver represents the extended capabilities of a desktop driver 
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Fyne API "desktop.Hoverable" 


desktop.Hoverable 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type Hoverable 


type Hoverable interface { 
// MouseIn is a hook that is called if the mouse pointer enters the element. 
MouselIn (*MouseEvent) 
// MouseMoved is a hook that is called if the mouse pointer moved over the element. 
MouseMoved (*MouseEvent ) 
// MouseOut is a hook that is called if the mouse pointer leaves th lement. 
MouseOut () 


} 
Hoverable is used when a canvas object wishes to know if a pointer device moves over it. 
Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 


4066 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


00000000 0 


0000000 0 


4067 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


00000 0 


0O00000 0 


O00 0 


4068 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


4069 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


4070 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


4071 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


4072 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


4073 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


4074 


© [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API ''desktop.Keyable"' 


desktop.Keyable 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 
type Keyable 


type Keyable interface { 
fyne.Focusable 


KeyDown (*fyne.KeyEvent) 
KeyUp (*fyne.KeyEvent) 


} 


Keyable describes any focusable canvas object that can accept desktop key events. This is the traditional 
key down and up event that is not applicable to all devices. 
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desktop.Modifier 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 

type Modifier 

type Modifier = fyne.KeyModifier 

Modifier captures any key modifiers (shift etc.) pressed during a key event 


Deprecated: Use fyne.KeyModifier instead. 
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import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type Mouseable 


type Mouseable interface { 
MouseDown (*MouseEvent ) 
MouseuUp (*MouseEvent) 


} 
Mouseable represents desktop mouse events that can be sent to CanvasObjects 
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desktop.MouseButton 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type MouseButton 

type MouseButton int 

MouseButton represents a single button in a desktop MouseEvent 
const ( 


// MouseButtonPrimary is the most common mouse button - on some systems the only one. 
// This will normally be on the left side of a mouse. 


ff 
// Since: 2.0 
MouseButtonPrimary MouseButton = 1 << iota 


// MouseButtonSecondary is the secondary button on most mouse input devices. 
// This will normally be on the right side of a mouse. 

// 

// Since: 2.0 

MouseButtonSecondary 


// MouseButtonTertiary is the middle button on the mouse, assuming it has one. 
as 

// Since: 2.0 

MouseButtonTertiary 


// LeftMouseButton is the most common mouse button - on some systems the only one. 


// Deprecated: use MouseButtonPrimary which will adapt to mouse configuration. 
LeftMouseButton = MouseButtonPrimary 


// RightMouseButton is the secondary button on most mouse input devices. 


// Deprecated: use MouseButtonSecondary which will adapt to mouse configuration. 
RightMouseButton = MouseButtonSecondary 
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desktop.MouseEvent 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type MouseEvent 


type MouseEvent struct { 
fyne.PointEvent 
Button MouseButton 
Modifier fyne.KeyModifier 


} 
MouseEvent contains data relating to desktop mouse events 
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desktop.StandardCursor 


import "fyne.io/fyne/v2/driver/desktop" 


Usage 


type StandardCursor 


type StandardCursor int 


StandardCursor represents a standard Fyne cursor. These values were previously of type fyne.Cursor. 


Since: 2.0 

const ( 
// DefaultCursor is the default cursor typically an arrow 
DefaultCursor StandardCursor = iota 
// TextCursor is the cursor often used to indicate text selection 
TextCursor 
// CrosshairCursor is the cursor often used to indicate bitmaps 
CrosshairCursor 
// PointerCursor is the cursor often used to indicate a link 
PointerCursor 
// HResizeCursor is the cursor often used to indicate horizontal resize 
HResizeCursor 
// VResizeCursor is the cursor often used to indicate vertical resize 
VResizeCursor 
// HiddenCursor will cause the cursor to not be shown 
HiddenCursor 


func (StandardCursor) Image 


func (d StandardCursor) Image() (image.Image, int, int) 
Image is not used for any of the StandardCursor types. 


Since: 2.0 
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mobile.Device 


import "fyne.io/fyne/v2/driver/mobile" 


Usage 


type Device 


type Device interface { 
// Request that the mobile device show the touch screen keyboard (standard layout) 
ShowVirtualKeyboard () 
// Request that the mobile device show the touch screen keyboard (custom layout) 
ShowVirtualKeyboardType (KeyboardType) 
// Request that the mobile device dismiss the touch screen keyboard 
HideVirtualKeyboard() 


} 
Device describes functionality only available on mobile 
Tags: 


If you like the Fyne toolkit please consider [sponsoring] [p ??] our work. 


4140 


Toggle navigation [p 11] 


@ [Nav][p ??] 

© [GitHut]|p 271 
© [Versions|[p 2? 
O [2.2][p 21] 
© [2.1][p 33] 
O [2.0][p 657] 
O [L4][p 1253] 
oO [1.3][p 1767] 
oO [1.2][p 2233] 


@ |Feedback|[p ??] 
e 


fF 


° [p22 
[p 2635] 
Hello World 
Application and RunLoop 
Updating Content 
Window Handling 
Unit Testing 
Packaging 
Mobile Packaging 
Distribution 
ce Metadata 
Eres: a 
Exploring Fynelip 27 
Gave and CanvasObject 
Container and Layouts 
Widget List 
Layout List 
Dialog List 
Handling Shortcuts 
Using the Preferences API 
System Tray 
Data Binding 
Sa Options 
Drawing and Animation|(p 22] 
e) Recuingle 
O Text 
© Line 


ce) 


OO0O000000 0 


OO0O00000 0 


4141 


Circle 
Image 
Raster 
Gradient 
Animation 
+ ComaeandT p22 
Box 
Grid 
Grid Wrap 
Border 
Form 
Center 
Max 
aes 
+ (ie 21 
‘abel 
Button 
Entry 
Choices 
Form 
ProgressBar 
Toolbar 
List 
Table 
Data Bindingl|p ? 
© [introduetion][p 2647 
© Binding Simple Widgets 
O Two-Way Binding 
© Data Conversion 
fe) List Data 
Extending Fynd|[p 2? 
© Building a Layout 
Write a Custom Widget 
Bundling resources 
Add a Custom Theme 
Extending Widgets 
Numerical Entry 
o [rchiectrllp 7 
© Geometry 
O Scaling 
O Widgets 
0 [p 2656] 
° [p 27] 


O00 0 


O0O000 0 


0O00000 0 


O00 0 


4142 


© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
[Animation] [p 2675] 


[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


4143 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 


4144 


© (RadialGradiend|{p 3408} 

e [Raster [p 3419] 

e [Rectangle|[p 3430] 

e {Text][p 3441] 

O [container] [p 3452] 

e [package containey|[p 34521 
[AppTabs]Ip 3464] 
[DocTabs][p 3476] 
[Scroll] [p 3487] 
[ScrolDirection][p 3497] 
[Split] [p 3506] 

[Tabltem][p 3516] 
[TabLocation)[p 3526] 

© [fata/binding][p 3535] 

package binding] [p 3535] 
[Bool] [p 3545] 

[BoolList|[p 3555] 
[Bytes|[p 3564] 
BytesLisi|[p 3573] 
[Pataltem]{p 3582] 
[DataList][p 3591] 
[DataListener|[p 3600] 
[DataMap]Ip 3609] 
[ExternalBooll[p 3618] 
[ExternalBoolLis{p 36271 
[ExtemalBytes][p 3636] 
[ExteralBytesLisi|[p 3645] 
[p 3654] 
[ExternalFloatlisi|[p 3663] 
[Externaling][p 3672] 
[ExternalintLis[p 3681] 
[ExternalRune][p 3690] 
ExternalRuneList|[p 3699] 
[p 3708) 
[ExternalStringLisi|[p 3717] 
[ExternalUntyped][p 37261 
[ExternalUntypedLis|[p 3735] 
[ExternalUntypedMap][p 37441 
[ExternalURI|[p 3753] 
[ExternalURILisi|[p 3762] 
[Float] [p 3771] 

[FloatLisi|[p 3781] 

[Ind [p 3790] 


4145 


[IntList][p 3800] 

[Rune] [p 3809] 

[RuneLisl][p 3818) 

[String] [p 3827] 

[StringLisi|[p 3838] 

[Struct|[p 3847] 

[Untyped][p 3856] 

[UntypedList[p 3865] 

[UntypedMap]|p 3874] 

[URI|[p 3883] 

e [URIList|[p 3893] 

© Gahadatalp 3902) 3902] 
package validation] [p 3902] 

O [dialog|[p 3912] 

© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 

e [Dialog][p 3943] 

© [EntryDialog]{p 3953] 

e 

e 


[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
© [package desktop] {p 3994] 
e [App|[p 4004] 
[Canvas][p 4013] 
[Cursor][p 4022] 
[Cursorabie]p 4031] 
[CustomShortcul][p 4040] 
Driver|[p 4049] 
[Hoverablel[p 4058] 
[Keyable][p 4067] 
[Modifier] [p 4076] 
[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
o [ifiver/mobilelip 4123) 
© [package mobitel[p 4123] 
e [Device][p 4132] 
© [Keyboardablelip 4141] 
© [KeyboardTypel[p 4150] 
e [Touchable|[p 4159] 


4146 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 

e [Spacer [p 4198] 

© [Spacer Object [p 4209] 
O [storage][p 4218] 

© [package storage] ip 4218) 

e [ExtensionFileFiltei|[p 4236] 

e |FileFilter|[p 4245] 

¢ [MimeTypeFiieFitey|[p 4254] 
© [Horage/repository[p 4263] 

© [package repository] [p 4263] 
[CopyableRepository)[p 4274] 
[CustomURIRepository][p 4283] 
[HierarchicalRepository|{p 4292] 
[ListableRepository][p 4301] 
[MovableRepository|[p 4311] 
[Repository] [p 4321] 
[WritableRepository][p 4332] 
O [test|[p 4341] 

© [package tesi]ip 4341] 

 [SofiwarePainter {p 4354] 

© [WindowlessCanvas][p 4363] 
O [theme][p 4373] 
[package theme][p 4373] 
[DisabledResource][p 4409] 
[ErrorThemedResource|{p 4418} 
[invertedThemedResource][p 4428] 
[PrimaryThemedResource|[p 4438] 
[ThemedResource][p 4448] 
O [widget][p 4458] 
package widgel|[p 4458] 
[Accordion][p 4470] 
[Accordiontiem]{p 4480) 
[BaseWidgel][p 4489] 
[Button|[p 4499] 
[ButtonAligal tp 4510) 
[ButtonlconPlacement|[p 4519] 
[Buttonimportance][p 4528] 
[ButionStyle][p 45371 
[Card] [p 4546] 


jon 


4147 


[Check|[p 4556] 
[CheckGroup]{p 45671 
[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 

[p 4611] 

[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 

[p 4684] 

[ListitemID]Ip 4695] 
[ListSegment|[p 4704] 

[p 4714] 
[Orientation|[p 47251 
[ParagraphSegment|{p 4734] 
[p 4744] 
[PopUpMenu][p 4755] 
ProgressBal][p 4766] 
[ProgressBarinfinitel[p 4776] 
[RadioGroup][p 4786] 
[RichTexi][p 4796] 
[RichTextBlocK][p 4807] 
[RichTextSegment][p 4816] 
[RichTextStyle][p 4825] 

[p 4834] 
[SelectEntry] Ip 4846] 

[p 4856] 
[SeparatorSegment][p 4866] 
[p 4876] 

[Table] [p 4887] 
[TableCeliID] [p 4898} 
[TextGrid][p 4907] 
[TextGridCelll[p 4918} 
[extGridRow|{p 4927] 
[TextGridStylel[p 4936] 
[TextSegmeni][p 4945] 
[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 


4148 


e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "mobile.Keyboardable" 


mobile.Keyboardable 


import "fyne.io/fyne/v2/driver/mobile" 


Usage 
type Keyboardable 


type Keyboardable interface { 
fyne.Focusable 


Keyboard() KeyboardType 
} 


Keyboardable describes any CanvasObject that needs a keyboard 
Tags: 
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Fyne API ''mobile.KeyboardType"' 


mobile.KeyboardType 


import 


"fyne.io/fyne/v2/driver/mobile" 


Usage 


type KeyboardType 


type KeyboardType int32 


KeyboardType represents a type of virtual keyboard 


const ( 


) 


Tags: 


// DefaultKeyboard is the keyboard with default input style and "return" return key 
DefaultKeyboard KeyboardType = iota 

// SingleLineKeyboard is the keyboard with default input style and "Done" return key 
SingleLineKeyboard 

// NumberKeyboard is the keyboard with number input style and "Done" return key 
NumberKeyboard 

// PasswordKeyboard is used to ensure that text is not leaked to 3rd party keyboard providers 
PasswordKeyboard 
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Fyne API "mobile.Touchable" 


mobile.Touchable 


import "fyne.io/fyne/v2/driver/mobile" 


Usage 
type Touchable 


type Touchable interface { 

TouchDown (*TouchEvent) 
TouchUp (*TouchEvent ) 
TouchCancel (*TouchEvent) 


} 
Touchable represents mobile touch events that can be sent to CanvasObjects 
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Fyne API "mobile.TouchEvent" 


mobile. TouchEvent 


import "fyne.io/fyne/v2/driver/mobile" 


Usage 


type TouchEvent 


type TouchEvent struct { 
fyne.PointEvent 


} 
TouchEvent contains data relating to mobile touch events 
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software 


import "fyne.io/fyne/v2/driver/software" 


Usage 
func NewCanvas 
func NewCanvas() test.WindowlessCanvas 


NewCanvas creates a new canvas in memory that can render without hardware support. 


func NewTransparentCanvas 


func NewTransparentCanvas() test.WindowlessCanvas 


NewTransparentCanvas creates a new canvas in memory that can render without hardware support 
without a background color. 


Since: 2.2 


func Render 


func Render(obj fyne.CanvasObject, t fyne.Theme) image.Imag 


Render takes a canvas object and renders it to a regular Go image using the provided Theme. The returned 
image will be set to the objectés minimum size. Use the theme.LightTheme() or theme.DarkTheme() to 
access the builtin themes. 


func RenderCanvas 


func RenderCanvas(c fyne.Canvas, t fyne.Theme) image.Imag 


RenderCanvas takes a canvas and renders it to a regular Go image using the provided Theme. This is the 
same as setting the application theme and then calling Canvas.Capture(). 
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layout 


import "fyne.io/fyne/v2/layout" 


Package layout defines the various layouts available to Fyne apps. 


Usage 
func NewAdaptiveGridLayout 
func NewAdaptiveGridLayout (rowcols int) fyne.Layout 


NewAdaptiveGridLayout returns a new grid layout which uses columns when horizontal but rows when 
vertical. 


func NewBorderLayout 


func NewBorderLayout (top, bottom, left, right fyne.CanvasObject) fyne.Layout 


NewBorderLayout creates a new BorderLayout instance with top, bottom, left and right objects set. All 
other items in the container will fill the centre space 


func NewCenterLayout 


func NewCenterLayout() fyne.Layout 


NewCenterLayout creates a new CenterLayout instance 


func NewFormLayout 


func NewFormLayout() fyne.Layout 


NewFormLayout returns a new FormLayout instance 
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func NewGridLayout 


func NewGridLayout (cols int) fyne.Layout 


NewGridLayout returns a grid layout arranged in a specified number of columns. The number of rows will 
depend on how many children are in the container that uses this layout. 


func NewGridLayoutWithColumns 
func NewGridLayoutWithColumns(cols int) fyne.Layout 


NewGridLayoutWithColumns returns a new grid layout that specifies a column count and wrap to new 
rows when needed. 


func NewGridLayoutWithRows 


func NewGridLayoutWithRows (rows int) fyne.Layout 


NewGridLayoutWithRows returns a new grid layout that specifies a row count that creates new rows as 
required. 


func NewGridWrapLayout 


func NewGridWrapLayout (size fyne.Size) fyne.Layout 
NewGridWrapLayout returns a new GridWrapLayout instance 
func NewHBoxLayout 

func NewHBoxLayout() fyne.Layout 


NewHBoxLayout returns a horizontal box layout for stacking a number of child canvas objects or widgets 
left to right. 


func NewMaxLayout 

func NewMaxLayout () fyne.Layout 

NewMaxLayout creates a new MaxLayout instance 
func NewPaddedLayout 

func NewPaddedLayout () fyne.Layout 
NewPaddedLayout creates a new PaddedLayout instance 


Since: 1.4 
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func NewSpacer 


func NewSpacer() fyne.CanvasObject 


NewSpacer returns a spacer object which can fill vertical and horizontal space. This is primarily used with 
a box layout. 


func NewVBoxLayout 


func NewVBoxLayout() fyne.Layout 


NewVBoxLayout returns a vertical box layout for stacking a number of child canvas objects or widgets 
top to bottom. 


types 
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Fyne API "layout.Spacer" 


layout.Spacer 


import "fyne.io/fyne/v2/layout" 


Usage 


type Spacer 
type Spacer struct { 
FixHorizontal bool 


FixVertical bool 


} 


Spacer is any simple object that can be used in a box layout to space out child objects 


func (*Spacer) ExpandHorizontal 


func (s *Spacer) ExpandHorizontal() bool 


ExpandHorizontal returns whether or not this spacer expands on the horizontal axis 


func (*Spacer) ExpandVertical 


func (s *Spacer) ExpandVertical() bool 

ExpandVertical returns whether or not this spacer expands on the vertical axis 
func (*Spacer) Hide 

func (s *Spacer) Hide () 


Hide removes this Spacer from layout calculations 
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func (*Spacer) MinSize 


func (s *Spacer) MinSize() fyne.Size 


MinSize returns a 0 size as a Spacer can shrink to no actual size 


func (*Spacer) Move 

func (s *Spacer) Move(pos fyne.Position) 

Move sets a new position for the Spacer - this will be called by the layout 
func (*Spacer) Position 

func (s *Spacer) Position() fyne.Position 

Position returns the current position of this Spacer 

func (*Spacer) Refresh 

func (s *Spacer) Refresh () 

Refresh does nothing for a spacer but is part of the CanvasObject definition 


func (*Spacer) Resize 


func (s *Spacer) Resize(size fyne.Size) 


Resize sets a new size for the Spacer - this will be called by the layout 


func (*Spacer) Show 
func (s *Spacer) Show() 
Show sets the Spacer to be part of the layout calculations 


func (*Spacer) Size 


func (s *Spacer) Size() fyne.Siz 


Size returns the current size of this Spacer 

func (*Spacer) Visible 

func (s *Spacer) Visible() bool 

Visible returns true if this spacer should affect the layout 
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Fyne API "layout.SpacerObject"' 


layout.SpacerObject 


import "fyne.io/fyne/v2/layout" 


Usage 
type SpacerObject 


type SpacerObject interface { 
ExpandVertical() bool 
ExpandHorizontal() bool 


} 
SpacerObject is any object that can be used to space out child objects 
Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 
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Fyne API "storage" 


storage 


import "fyne.io/fyne/v2/storage" 


Package storage provides storage access and management functionality. 


Usage 


var URIRootError = repository.ErrURIRoot 
URIRootError is a wrapper for repository. URIRootError 
Deprecated - use repository.ErrURIRoot instead 
func CanList 
func CanList(u fyne.URI) (bool, error) 
CanList will determine if the URI is listable or not. 
This method may fail in several ways: 
@ Different permissions or credentials are required to check if the 
URI supports listing. 


@ This URI scheme could represent some resources that can be listed, 


but this specific URI is not one of them (e.g. a file ona 
filesystem, as opposed to a directory). 


@ Checking for listability depended on a lower level operation 


such as network or filesystem access that has failed in some way. 


@ Ifthe scheme of the given URI does not have a registered 
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ListableRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


CanList is backed by the repository system - this function calls into a scheme-specific implementation 
from a registered repository. 


Since: 2.0 
func CanRead 
func CanRead(u fyne.URI) (bool, error) 


CanRead determines if a given URI could be written to using the Reader() method. It is preferred to check 
if a URI is readable using this method before calling Reader(), because the underlying operations required 
to attempt to read and then report an error may be slower than the operations needed to test if a URI is 
readable. Keep in mind however that even if CanRead returns true, you must still do appropriate error 
handling for Reader(), as the underlying filesystem may have changed since you called CanRead. 


The non-existence of a resource should not be treated as an error. In other words, a Repository 
implementation which for some URI u returns false, nil for Exists(u), CanRead(u) should also return false, 
nil. 


CanRead is backed by the repository system - this function calls into a scheme-specific implementation 
from a registered repository. 


Since: 2.0 


func CanWrite 


func CanWrite(u fyne.URI) (bool, error) 


CanWrite is backed by the repository system - this function calls into a scheme-specific implementation 
from a registered repository. 


Since: 2.0 


func Child 


func Child(u fyne.URI, component string) (fyne.URI, error) 


Child returns a URI referencing a resource nested hierarchically below the given URI, identified by a 
string. For example, the child with the string component aquuxa of afile://foo/bara is afile://foo/bar/quuxa. 


This can fail in several ways: 


e@ Ifthe URI refers to a resource which does not exist in a hierarchical 


context (e.g. the URI references something which does not have a 
semantically meaningful "child"), the Child() implementation may return an 
error. 
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@ If generating a reference to a child of the referenced resource requires 
interfacing with some external system, failures may propagate through the 


Child() implementation. It is expected that this case would occur very 
rarely if ever. 


@ Ifthe scheme of the given URI does not have a registered 


HierarchicalRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


NOTE: since v2.0.0, Child() is backed by the repository system - this function is a helper which calls into 
an appropriate repository instance for the scheme of the URI it is given. 


Since: 1.4 


func Copy 


func Copy(source fyne.URI, destination fyne.URI) error 


Copy given two URIs, asrca, and adesta both of the same scheme, will copy one to the other. If the source 
and destination are of different schemes, then the Copy implementation for the storage repository 
registered to the scheme of the source will be used. Implementations are recommended to use 
repository.GenericCopy() as a fail-over in the case that they do not understand how to operate on the 
scheme of the destination URI. However, the behavior of calling CopyQ on URIs of non-matching 
schemes is ultimately defined by the storage repository registered to the scheme of the source URI. 


This method may fail in several ways: 
e@ Different permissions or credentials are required to perform the 
copy operation. 


@ This URI scheme could represent some resources that can be copied, 


but either the source, destination, or both are not resources 
that support copying. 


@ Performing the copy operation depended on a lower level operation 
such as network or filesystem access that has failed in some way. 
e@ Ifthe scheme of the given URI does not have a registered 


CopyableRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


Copy is backed by the repository system - this function calls into a scheme-specific implementation from a 
registered repository. 
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Since: 2.0 


func CreateListable 


func CreateListable(u fyne.URI) error 


CreateListable creates a new listable resource referenced by the given URI. CreateListable will error if the 
URI already references an extant resource. This method is used for storage repositories where listable 
resources are of a different underlying type than other resources - for example, in a typical filesystem 
(afile://4), CreateListable() corresponds to directory creation, and Writer() implies file creation for 
non-extant operands. 


For storage repositories where listable and non-listable resources are the of the same underlying type, 
CreateListable should be equivalent to calling Writer(), writing zero bytes, and then closing the 
‘URIWriteCloser - in filesystem terms, the same as calling atouch;a. 


Storage repositories which support listing, but not creation of listable objects may return 
repository.ErrOperationNotSupported. 


CreateListable should generally fail if the parent of itas operand does not exist, however this can vary by 
the implementation details of the specific storage repository. In filesystem terms, this function is Amkdira 
not Amkdir -pa. 


This method may fail in several ways: 
e@ Different permissions or credentials are required to create the requested 
resource. 
@ Creating the resource depended on a lower level operation such as network 
or filesystem access that has failed in some way. 
@ Ifthe scheme of the given URI does not have a registered 


ListableRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


CreateListable is backed by the repository system - this function either calls into a scheme-specific 
implementation from a registered repository, or fails with a URIOperationNotSupported error. 


Since: 2.0 


func Delete 


func Delete(u fyne.URI) error 


Delete destroys, deletes, or otherwise removes the resource referenced by the URI. 
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This can fail in several ways: 


@ If removing the resource requires interfacing with some external system, 


failures may propagate through Destroy(). For example, deleting a file may 
fail with a permissions error. 


@ Ifthe referenced resource does not exist, attempting to destroy it should 
throw an error. 
@ Ifthe scheme of the given URI does not have a registered 


WritableRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


Delete is backed by the repository system - this function calls into a scheme-specific implementation from 
a registered repository. 


Since: 2.0 


func Exists 


func Exists(u fyne.URI) (bool, error) 
Exists determines if the resource referenced by the URI exists. 
This can fail in several ways: 


e@ If checking the existence of a resource requires interfacing with some 


external system, then failures may propagate through Exists(). For 
example, checking the existence of a resource requires reading a directory 
may result in a permissions error. 


It is understood that a non-nil error value signals that the existence or non-existence of the resource cannot 
be determined and is undefined. 


NOTE: since v2.0.0, Exists is backed by the repository system - this function calls into a scheme-specific 
implementation from a registered repository. 


Exists may call into either a generic implementation, or into a scheme-specific implementation depending 
on which storage repositories have been registered. 


Since: 1.4 
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func List 


func List(u fyne.URI) ([]fyne.URI, error) 


List returns a list of URIs that reference resources which are nested below the resource referenced by the 
argument. For example, listing a directory on a filesystem should return a list of files and directories it 
contains. 


This method may fail in several ways: 

e@ Different permissions or credentials are required to obtain a 
listing for the given URI. 

@ This URI scheme could represent some resources that can be listed, 
but this specific URI is not one of them (e.g. a file ona 
filesystem, as opposed to a directory). This can be tested in advance 
using the Listable() function. 

® Obtaining the listing depended on a lower level operation such as 
network or filesystem access that has failed in some way. 

@ Ifthe scheme of the given URI does not have a registered 


ListableRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


List is backed by the repository system - this function either calls into a scheme-specific implementation 
from a registered repository, or fails with a URIOperationNotSupported error. 


Since: 2.0 


func ListerForURI 

func ListerForURI (uri fyne.URI) (fyne.ListableURI, error) 

ListerForURI will attempt to use the applicationas driver to convert a standard URI into a listable URI. 
Since: 1.4 

func LoadResourceFromURI 

func LoadResourceFromURI(u fyne.URI) (fyne.Resource, error) 


LoadResourceFromURI creates a new StaticResource in memory using the contents of the specified URI. 
The URI will be opened using the current driver, so valid schemas will vary from platform to platform. 
The file:// schema will always work. 
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func Move 


func Move(source fyne.URI, destination fyne.URI) error 


Move returns a method that given two URIs, asrca and adesta both of the same scheme this will move src 
to dest. This means the resource referenced by src will be copied into the resource referenced by dest, and 
the resource referenced by src will no longer exist after the operation is complete. 


If the source and destination are of different schemes, then the Move implementation for the storage 
repository registered to the scheme of the source will be used. Implementations are recommended to use 
repository.GenericMove() as a fail-over in the case that they do not understand how to operate on the 
scheme of the destination URI. However, the behavior of calling Move() on URIs of non-matching 
schemes is ultimately defined by the storage repository registered to the scheme of the source URI. 


This method may fail in several ways: 
@ Different permissions or credentials are required to perform the 
rename operation. 


@ This URI scheme could represent some resources that can be renamed, 


but either the source, destination, or both are not resources 
that support renaming. 


@ Performing the rename operation depended on a lower level operation 
such as network or filesystem access that has failed in some way. 
@ Ifthe scheme of the given URI does not have a registered 


MovableRepository instance, then this method will fail witha 
repository.ErrOperationNotSupported. 


Move is backed by the repository system - this function calls into a scheme-specific implementation from 
a registered repository. 


Since: 2.0 


func NewFileURI 


func NewFileURI (path string) fyne.URI 


NewFileURI creates a new URI from the given file path. 


func NewURI 


func NewURI(s string) fyne.URI 
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NewURI creates a new URI from the given string representation. This could be a URI from an external 
source or one saved from URI StringQ 


Deprecated: use ParseURI instead 


func OpenFileFromURI 


func OpenFileFromURI (uri fyne.URI) (fyne.URIReadCloser, rror) 


OpenFileFromURI loads a file read stream from a resource identifier. This is mostly provided so that file 
references can be saved using their URI and loaded again later. 


Deprecated: this has been replaced by storage.Reader(URI) 


func Parent 


func Parent (u fyne.URI) (fyne.URI, error) 


Parent returns a URI referencing the parent resource of the resource referenced by the URI. For example, 
the Parent() of afile://foo/bar.baza is afile://fooa. The URI which is returned will be listable. 


NOTE: it is not a given that Parent() return a parent URI with the same Scheme(), though this will 
normally be the case. 


This can fail in several ways: 


e@ Ifthe URI refers to a filesystem root, then the Parent() implementation 


must return (nil, URIRootError). 


e@ Ifthe URI refers to a resource which does not exist in a hierarchical 


context (e.g. the URI references something which does not have a 
semantically meaningful "parent"), the Parent() implementation may return 
an error. 


@ If determining the parent of the referenced resource requires 


interfacing with some external system, failures may propagate 
through the Parent() implementation. For example if determining 
the parent of a file:// URI requires reading information from 
the filesystem, it could fail with a permission error. 


@ Ifthe scheme of the given URI does not have a registered 


HierarchicalRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


NOTE: since v2.0.0, Parent() is backed by the repository system - this function is a helper which calls into 
an appropriate repository instance for the scheme of the URI it is given. 
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Since: 1.4 


func ParseURI 
func ParseURI(s string) (fyne.URI, error) 


ParseURI creates a new URI instance by parsing a URI string. 


Parse URI will parse up to the first 4:4 present in the URI string to extract the scheme, and then delegate 
further parsing to the registered repository for the given scheme. If no repository is registered for that 
scheme, the URI is parsed on a best-effort basis using net/url. 


As a Special exception, URIs beginning with afile:4 are always parsed using NewFileURIQ, which will 
correctly handle back-slashes appearing in the URI path component on Windows. 


Since: 2.0 


func Reader 


func Reader(u fyne.URI) (fyne.URIReadCloser, error) 


Reader returns URIReadCloser set up to read from the resource that the URI references. 
This method can fail in several ways: 


e@ Different permissions or credentials are required to read the 


referenced resource. 


@ This URI scheme could represent some resources that can be read, 


but this particular URI references a resources that is not 
something that can be read. 


e@ Attempting to set up the reader depended on a lower level 


operation such as a network or filesystem access that has failed 
in some way. 


Reader is backed by the repository system - this function calls into a scheme-specific implementation from 
a registered repository. 


Since: 2.0 


func SaveFileToURI 


func SaveFileToURI (uri fyne.URI) (fyne.URIWriteCloser, error) 


SaveFileToURI loads a file write stream to a resource identifier. This is mostly provided so that file 
references can be saved using their URI and written to again later. 
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Deprecated: this has been replaced by storage. Writer(URD 

func Writer 

func Writer(u fyne.URI) (fyne.URIWriteCloser, error) 

Writer returns URIWriteCloser set up to write to the resource that the URI references. 


Writing to a non-extant resource should create that resource if possible (and if not possible, this should be 
reflected in the return of CanWrite()). Writing to an extant resource should overwrite it in-place. At 
present, this API does not provide a mechanism for appending to an already-extant resource, except for 
reading it in and writing all the data back out. 


This method can fail in several ways: 


e@ Different permissions or credentials are required to write to the 


referenced resourc 


@ This URI scheme could represent some resources that can be 


written, but this particular URI references a resources that is 
not something that can be written. 


e@ Attempting to set up the writer depended on a lower level 


operation such as a network or filesystem access that has failed 
in some way. 


@ Ifthe scheme of the given URI does not have a registered 


WritableRepository instance, then this method will fail with a 
repository.ErrOperationNotSupported. 


Writer is backed by the repository system - this function calls into a scheme-specific implementation from 
a registered repository. 


Since: 2.0 
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Fyne API "storage.ExtensionFileFilter"' 


storage.ExtensionFileFilter 


import "fyne.io/fyne/v2/storage" 


Usage 


type ExtensionFileFilter 


type ExtensionFileFilter struct { 
Extensions []string 


} 


ExtensionFileFilter represents a file filter based on the the ending of file names, for example 4.txta and 
a.pnga. 


func (*ExtensionFileFilter) Matches 


func (e *ExtensionFileFilter) Matches(uri fyne.URI) bool 
Matches returns true if a file URI has one of the filtered extensions. 
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storage.FileFilter 


import "fyne.io/fyne/v2/storage" 


Usage 


type FileFilter 


type FileFilter interface { 
Matches (fyne.URI) bool 


} 


FileFilter is an interface that can be implemented to provide a filter to a file dialog. 


func NewExtensionFileFilter 


func NewExtensionFileFilter(extensions []string) FileFilter 


NewExtensionFileFilter takes a string slice of extensions with a leading . and creates a filter for the file 
dialog. Example: .jpg, .mp3, .txt, .sh 


func NewMimeTypeFileFilter 


func NewMimeTypeFileFilter(mimeTypes []string) FileFilter 


NewMimeTypeFileFilter takes a string slice of mimetypes, including globs, and creates a filter for the file 
dialog. Example: image/, audio/mp3, text/plain, application/ 
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Fyne API "storage.MimeTypeFileFilter"' 


storage.MimeTypeFileFilter 


import "fyne.io/fyne/v2/storage" 


Usage 
type MimeTypeFileFilter 


type MimeTypeFileFilter struct { 
MimeTypes []string 
} 


MimeTypeFileFilter represents a file filter based on the files mime type, for example dimage/*a, 
aaudio/mp3a. 


func (*“MimeTypeFileFilter) Matches 


func (mt *MimeTypeFileFilter) Matches(uri fyne.URI) bool 


Matches returns true if a file URI has one of the filtered mimetypes. 
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Fyne API "repository' 


repository 


import "fyne.io/fyne/v2/storage/repository" 


Package repository provides primitives for working with storage repositories. 


Usage 


var ( 
// ErrOperationNotSupported may be thrown by certain functions in the storage 
// or repository packages which operate on URIs if an operation is attempted 
// that is not supported for the scheme relevant to the URI, normally because 
// the underlying repository has either not implemented the relevant function, 
// or has explicitly returned this error. 
// 
// Since: 2.0 
ErrOperationNotSupported = errors.New("operation not supported for this URI") 
// ErrURIRoot should be thrown by fyne.URI implementations when the caller 
// attempts to take the parent of the root. This way, downstream code that 
// wants to programmatically walk up a URIs parent’s will know when to stop 
// iterating. 
// 
// Since: 2.0 
ErrURIRoot = errors.New("cannot take the parent of the root element in a URI") 
) 
func GenericChild 
func GenericChild(u fyne.URI, component string) (fyne.URI, error) 


GenericChild can be used as a common-case implementation of HierarchicalRepository.Child(). It will 
create a child URI by separating the URI into itaés component parts as described in IETF RFC 3986, then 
appending 4/4 + component to the path, then concatenating the result and parsing it as anew URL. 


NOTE: this function should not be called except by an implementation of the Repository interface - using 
this for unknown URIs may break. 
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Since: 2.0 


func GenericCopy 


func GenericCopy (source fyne.URI, destination fyne.URI) error 


GenericCopy can be used a common-case implementation of CopyableRepository.Copy(). It will perform 
the copy by obtaining a reader for the source URI, a writer for the destination URI, then writing the 
contents of the source to the destination. 


For obvious reasons, the destination URI must have a registered WritableRepository. 


NOTE: this function should not be called except by an implementation of the Repository interface - using 
this for unknown URIs may break. 


Since: 2.0 


func GenericMove 


func GenericMove (source fyne.URI, destination fyne.URI) error 


GenericMove can be used a common-case implementation of MovableRepository.Move(). It will perform 
the move by obtaining a reader for the source URI, a writer for the destination URI, then writing the 
contents of the source to the destination. Following this, the source will be deleted using 
WritableRepository.Delete. 


For obvious reasons, the source and destination URIs must both be writable. 


NOTE: this function should not be called except by an implementation of the Repository interface - using 
this for unknown URIs may break. 


Since: 2.0 
func GenericParent 
func GenericParent(u fyne.URI) (fyne.URI, error) 


GenericParent can be used as a common-case implementation of HierarchicalRepository.Parent(). It will 
create a parent URI based on IETF RFC3986. 


In short, the URI is separated into itas component parts, the path component is split along instances of 4/4, 
and the trailing element is removed. The result is concatenated and parsed as a new URI. 


If the URI path is empty or 4/4, then a nil URI is returned, along with ErrURIRoot. 


NOTE: this function should not be called except by an implementation of the Repository interface - using 
this for unknown URIs may break. 


Since: 2.0 
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func NewFileURI 


func NewFileURI (path string) fyne.URI 


NewFileURI implements the back-end logic to storage.NewFileURI, which you should use instead. This is 
only here because other functions in repository need to call it, and it prevents a circular import. 


Since: 2.0 
func ParseURI 
func ParseURI(s string) (fyne.URI, error) 


ParseURI implements the back-end logic for storage.ParseURI, which you should use instead. This is only 
here because other functions in repository need to call it, and it prevents a circular import. 


Since: 2.0 


func Register 


func Register(scheme string, repository Repository) 


Register registers a storage repository so that operations on URIs of the registered scheme will use 
methods implemented by the relevant repository implementation. 


Since: 2.0 
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Fyne API "repository.CopyableRepository"' 


repository.CopyableRepository 


import "fyne.io/fyne/v2/storage/repository" 


Usage 


type CopyableRepository 


type CopyableRepository interface { 
Repository 


// Copy will be used to implement calls to storage.Copy() for the 
// vegistered scheme of this repository. 

// 

// A generic implementation is provided by GenericCopy(). 

// 

// NOTE: the first parameter is the source, the second is the 

// destination. 

// 
// NOTE: if storage.Copy() is given two URIs of different schemes, it 
// is possible that only the source URI will be of the type this 

// repository is registered to handle. In such cases, implementations 
// are suggested to fail-over to GenericCopy(). 

// 

// Since: 2.0 

Copy (fyne.URI, fyne.URI) error 


} 


CopyableRepository is an extension of the Repository interface which also supports copying referenced 
resources from one URI to another. 
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Fyne API "repository.CustomURIRepository" 


repository.CustomURIRepository 


import "fyne.io/fyne/v2/storage/repository" 


Usage 


type CustomURIRepository 


type CustomURIRepository interface { 
Repository 


// ParseURI will be used to implement calls to storage.ParseURI () 
// for the registered scheme of this repository. 
ParseURI (string) (fyne.URI, error) 


} 


CustomURIRepository is an extension of the repository interface which allows the behavior of 
storage.ParseURI to be overridden. This is only needed if you wish to generate custom URI types, rather 
than using Fyneas URI implementation and net/url based parsing. 


NOTE: even for URIs with non-RFC3986-compliant encoding, the URI MUST begin with ascheme:4, or 
storage.ParseURI() will not be able to determine which storage repository to delegate to for parsing. 
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Fyne API "repository.HierarchicalRepository" 


repository.HierarchicalRepository 


import "fyne.io/fyne/v2/storage/repository" 


Usage 


type HierarchicalRepository 


type HierarchicalRepository interface { 


Repository 

// Parent will be used to implement calls to storage.Parent() for the 
// vegistered scheme of this repository. 

// 

// A generic implementation is provided in GenericParent(), which 

// is based on the RFC3986 definition of a URI parent. 

// 


// Since: 2.0 
Parent (fyne.URI) (fyne.URI, error) 


// Child will be used to implement calls to storage.Child() for 
// the registered scheme of this repository. 


// A generic implementation is provided in GenericParent(), which 
// is based on RFC3986. 


// Since: 2.0 
Child(fyne.URI, string) (fyne.URI, error) 
} 


HierarchicalRepository is an extension of the Repository interface which also supports determining the 
parent and child items of a URI. 
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Fyne API "'repository.ListableRepository" 


repository.ListableRepository 


import "fyne.io/fyne/v2/storage/repository" 


Usage 


type ListableRepository 


type ListableRepository interface { 


Repository 

// CanList will be used to implement calls to storage.Listable() for 
// the registered scheme of this repository. 

// 


// Since: 2.0 
CanList(u fyne.URI) (bool, error) 


// List will be used to implement calls to storage.List() for the 
// cvegistered scheme of this repository. 

// 

// Since: 2.0 

List (u fyne.URI) ([]fyne.URI, error) 


// CreateListable will be used to implement calls to 
// storage.CreateListable() for the registered scheme of this 
// repository. 


// Since: 2.0 
CreateListable(u fyne.URI) error 


} 


ListableRepository is an extension of the Repository interface which also supports obtaining directory 
listings (generally analogous to a directory listing) for URIs of the scheme it is registered to. 
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Fyne API "'repository.MovableRepository" 


repository.MovableRepository 


import "fyne.io/fyne/v2/storage/repository" 


Usage 


type MovableRepository 


type MovableRepository interface { 


Repository 

// Move will be used to implement calls to storage.Move() for the 

// vegistered scheme of this repository. 

// 

// A generic implementation is provided by GenericMove(). 

// 

// NOTE: the first parameter is the source, the second is the 

// destination. 

// 

// NOTE: if storage.Move() is given two URIs of different schemes, it 
// is possible that only the source URI will be of the type this 

// repository is registered to handle. In such cases, implementations 
// are suggested to fail-over to GenericMove(). 

// 

// Since: 2.0 


Move (fyne.URI, fyne.URI) error 


} 


MovableRepository is an extension of the Repository interface which also supports moving referenced 
resources from one URI to another. 


Note: both Moveable and Movable are correct spellings, but Movable is newer and more accepted. Source: 
https://grammarist.com/spelling/movable-moveable/ 
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Fyne 


API "repository.Repository" 


repository.Repository 


import " 


Usage 


fyne.io/fyne/v2/storage/repository" 


type Repository 

type Repository interface { 
// Exists will be used to implement calls to storage.Exists() for the 
// cvegistered scheme of this repository. 
// 


// Since: 2.0 
Exists(u fyne.URI) (bool, error) 


// Reader will be used to implement calls to storage.Reader () 
// for the registered scheme of this repository. 

// 

// Since: 2.0 

Reader(u fyne.URI) (fyne.URIReadCloser, rror) 


// CanRead will be used to implement calls to storage.CanRead() for the 
// cvegistered scheme of this repository. 

// 

// Since: 2.0 

CanRead(u fyne.URI) (bool, error) 


// Destroy is called when the repository is un-registered from a given 
// URI scheme. 

// 

// The string parameter will be the URI scheme that the repository was 
// vegistered for. This may be useful for repositories that need to 

// Randle more than one URI scheme internally. 

// 

// Since: 2.0 

Destroy (string) 
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Repository represents a storage repository, which is a set of methods which implement specific functions 
on a URI. Repositories are registered to handle specific URI schemes, and the higher-level functions that 
operate on URIs internally look up an appropriate method from the relevant Repository. 


The repository interface includes only methods which must be implemented at a minimum. Without 
implementing all of the methods in this interface, a URI would not be usable in a useful way. Additional 
functionality can be exposed by using interfaces which extend Repository. 


Repositories are registered to handle a specific URI scheme (or schemes) using the Register() method. 
When a higher-level URI function such as storage.Copy() is called, the storage package will internally 
look up the repository associated with the scheme of the URI, then it will use a type assertion to check if 
the repository implements CopyableRepository. If so, the Copy() function will be run from the repository, 
otherwise storage.Copy() will return NotSupportedError. This works similarly for all other methods in 
repository-related interfaces. 


Note that a repository can be registered for multiple URI schemes. In such cases, the repository must 
internally select and implement the correct behavior for each URI scheme. 


A repository will only ever need to handle URIs with schemes for which it was registered, with the 
exception that functions with more than | operand such as Copy() and Move(), in which cases only the 
first operand is guaranteed to match a scheme for which the repository is registered. 


NOTE: most developers who use Fyne should not generally attempt to call repository methods directly. 
You should use the methods in the storage package, which will automatically detect the scheme of a URI 
and call into the appropriate repository. 


Since: 2.0 


func ForScheme 


func ForScheme(scheme string) (Repository, error) 
ForScheme returns the Repository instance which is registered to handle URIs of the given scheme. 


NOTE: this function is intended to be used specifically by the storage package. It generally should not be 
used outside of the fyne package - instead you should use the methods in the storage package. 


Since: 2.0 


func ForURI 


func ForURI(u fyne.URI) (Repository, error) 


ForURI returns the Repository instance which is registered to handle URIs of the given scheme. This is a 
helper method that calls ForScheme() on the scheme of the given URI. 


NOTE: this function is intended to be used specifically by the storage package. It generally should not be 
used outside of the fyne package - instead you should use the methods in the storage package. 
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repository.WritableRepository 


import " 


Usage 


fyne.io/fyne/v2/storage/repository" 


type WritableRepository 


type Wri 


} 


tableRepository interface { 
Repository 


// Writer will be used to implement calls to storage.WriterTo() for 
// the registered scheme of this repository. 

// 

// Since: 2.0 

Writer(u fyne.URI) (fyne.URIWriteCloser, error) 


// CanWrite will be used to implement calls to storage.CanWrite() for 
// the registered scheme of this repository. 
// 


// Since: 2.0 
CanWrite(u fyne.URI) (bool, error) 


// Delete will be used to implement calls to storage.Delete() for the 
// cvegistered scheme of this repository. 

// 

// Since: 2.0 

Delete(u fyne.URI) error 


WritableRepository is an extension of the Repository interface which also supports obtaining a writer for 
URIs of the scheme it is registered to. 
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© [List My Applip 5023] 


Fyne API "test" 
[Edit me] 


test 


import "fyne.io/fyne/v2/test" 


Package test provides utility drivers for running UI tests without rendering to a screen. 


Usage 
func ApplyTheme 


func ApplyTheme(t *testing.T, theme fyne.Theme) 


ApplyTheme sets the given theme and waits for it to be applied to the current app. 


func AssertCanvasTappableAt 


func AssertCanvasTappableAt (t *testing.T, c fyne.Canvas, pos fyne.Position) bool 


AssertCanvasTappableAt asserts that the canvas is tappable at the given position. 


func AssertImageMatches 


func AssertImageMatches(t *testing.T, masterFilename string, img image.Image, msgAndArgs ...interface{}) bool 


AssertImageMatches asserts that the given image is the same as the one stored in the master file. The 
master filename is relative to the test data directory which is relative to the test. The test t fails if the 
given image is not equal to the loaded master image. In this case the given image is written into a file in 
testdata/failed/<masterFilename> (relative to the test). This path is also reported, thus the 
file can be used as new master. 


func AssertNotificationSent 


func AssertNotificationSent(t *testing.T, n *fyne.Notification, f func()) 


AssertNotificationSent allows an app developer to assert that a notification was sent. After the content of f 
has executed this utility will check that the specified notification was sent. 


4349 


func AssertRendersToMarkup 


func AssertRendersToMarkup(t *testing.T, masterFilename string, c fyne.Canvas, msgAndArgs ...interface{}) bool 


AssertRendersToMarkup asserts that the given canvas renders the same markup as the one stored in the 
master file. The master filename is relative to the test data directory which is relative to the test. The 
test t fails if the rendered markup is not equal to the loaded master markup. In this case the rendered 
markup is written into a file in testdata/failed/<masterFilename> (relative to the test). This 
path is also reported, thus the file can be used as new master. 


Be aware, that the indentation has to use tab characters (a\ta) instead of spaces. Every element starts on a 

new line indented one more than its parent. Closing elements stand on their own line, too, using the same 
indentation as the opening element. The only exception to this are text elements which do not contain line 
breaks unless the text includes them. 


Since: 2.0 


func Canvas 

func Canvas() fyne.Canvas 

Canvas returns a reusable in-memory canvas used for testing 

func DoubleTap 

func DoubleTap(obj fyne.DoubleTappable) 

DoubleTap simulates a double left mouse click on the specified object. 

func Drag 

func Drag(c fyne.Canvas, pos fyne.Position, deltaX, deltaY float32) 


Drag drags at an absolute position on the canvas. deltaX/Y is the dragging distance: <0 for dragging 
up/left, >O for dragging down/right. 


func FocusNext 


func FocusNext(c fyne.Canvas) 


FocusNext focuses the next focusable on the canvas. 


func FocusPrevious 


func FocusPrevious(c fyne.Canvas) 


FocusPrevious focuses the previous focusable on the canvas. 
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func LaidOutObjects 


func LaidOutObjects(o fyne.CanvasObject) (objects []fyne.CanvasObject) 


LaidOutObjects returns all fyne.CanvasObject starting at the given fyne.CanvasObject which is laid out 
previously. 


func MoveMouse 

func MoveMouse(c fyne.Canvas, pos fyne.Position) 
MoveMouse simulates a mouse movement to the given position. 
func NewApp 

func NewApp() fyne.App 


NewApp returns a new dummy app used for testing. It loads a test driver which creates a virtual window 
in memory for testing. 


func NewClipboard 


func NewClipboard() fyne.Clipboard 


NewClipboard returns a single use in-memory clipboard used for testing 


func NewDriver 


func NewDriver() fyne.Driver 


NewDriver sets up and registers a new dummy driver for test purpose 


func NewDriver WithPainter 


func NewDriverWithPainter (painter SoftwarePainter) fyne.Driver 


NewDriverWithPainter creates a new dummy driver that will pass the given painter to all canvases created 


func NewTheme 


func NewTheme() fyne.Them 


NewTheme returns a new testTheme. 


func NewWindow 


func NewWindow(content fyne.CanvasObject) fyne.Window 


NewWindow creates and registers a new window for test purposes 
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func Scroll 


func Scroll(c fyne.Canvas, pos fyne.Position, deltaX, deltaY float32) 


Scroll scrolls at an absolute position on the canvas. deltaX/Y is the scrolling distance: <O for scrolling 
up/left, >O for scrolling down/right. 


func Tap 

func Tap(obj fyne.Tappable) 

Tap simulates a left mouse click on the specified object. 
func TapAt 

func TapAt (obj fyne.Tappable, pos fyne.Position) 


TapAt simulates a left mouse click on the passed object at a specified place within it. 


func TapCanvas 

func TapCanvas(c fyne.Canvas, pos fyne.Position) 

TapCanvas taps at an absolute position on the canvas. 

func TapSecondary 

func TapSecondary(obj fyne.SecondaryTappable) 

TapSecondary simulates a right mouse click on the specified object. 

func TapSecondaryAt 

func TapSecondaryAt (obj fyne.SecondaryTappable, pos fyne.Position) 
TapSecondaryAt simulates a right mouse click on the passed object at a specified place within it. 


func Theme 


func Theme() fyne.Them 


Theme returns a theme useful for image based tests. 
func Type 
func Type(obj fyne.Focusable, chars string) 


Type performs a series of key events to simulate typing of a value into the specified object. The focusable 
object will be focused before typing begins. The chars parameter will be input one rune at a time to the 
focused object. 
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func TypeOnCanvas 


func TypeOnCanvas(c fyne.Canvas, chars string) 


TypeOnCanvas is like the Type function but it passes the key events to the canvas object rather than a 
focusable widget. 


func WidgetRenderer 


func WidgetRenderer (wid fyne.Widget) fyne.WidgetRenderer 


WidgetRenderer allows test scripts to gain access to the current renderer for a widget. This can be used for 
verifying correctness of rendered components for a widget in unit tests. 


func WithTestTheme 


func WithTestTheme(t *testing.T, f func()) 


WithTestTheme runs a function with the testTheme temporarily set. 


types 
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Fyne API "'test.SoftwarePainter"' 


test.SoftwarePainter 


import "fyne.io/fyne/v2/test" 


Usage 


type SoftwarePainter 


type SoftwarePainter interface { 
Paint (fyne.Canvas) image.Image 


} 
SoftwarePainter describes a simple type that can render canvases 
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e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodelD][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "test.WindowlessCanvas"' 


test. WindowlessCanvas 


import "fyne.io/fyne/v2/test" 


Usage 


type WindowlessCanvas 


type WindowlessCanvas interface { 
fyne.Canvas 


Padded() bool 
Resize (fyne.Size) 
SetPadded (bool) 
SetScale (float32) 


} 


WindowlessCanvas provides functionality for a canvas to operate without a window 


func NewCanvas 

func NewCanvas() WindowlessCanvas 

NewCanvas returns a single use in-memory canvas used for testing 

func NewCanvasWithPainter 

func NewCanvasWithPainter (painter SoftwarePainter) WindowlessCanvas 


NewCanvasWithPainter allows creation of an in-memory canvas with a specific painter. The painter will 
be used to render in the Capture() call. 


func NewTransparentCanvasWithPainter 


func NewTransparentCanvasWithPainter (painter SoftwarePainter) WindowlessCanvas 
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NewTransparentCanvasWithPainter allows creation of an in-memory canvas with a specific painter 
without a background color. The painter will be used to render in the Capture() call. 


Since: 2.2 
Tags: 


If you like the Fyne toolkit please consider|sponsoring| [p ??] our work. 
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© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 
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DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
[Lifecycle]Ip 2910] 
[ListableURI][p 2919} 
[MainMenu][p 2928} 
[Menu][p 2937] 
[Menuttem){p 2946] 
[Notification][p 2956] 
[OverlayStack][p 2965] 
[PointEvend][p 29741 
[Position] [p 2983] 
[Preferencey|[p 2993) 
[Resource][p 3003] 
[Scroflable]{p 3012] 


4375 


[ScrofiEvend|{p 3021] 
[SecondaryTappable{p 3030] 
[Settings][p 3039] 
[Shortcut] [p 3048] 
[p 3057] 
[p 3066] 
[p 3076] 
[ShortcutHandler][p 3086] 
[ShortcutPaste]{p 3095] 
[ShortcutSelectATl|[p 3105] 
[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
[Fabbablel[p 3153] 
[p 3162] 
[TextAlign][p 3171] 
[TextStylelIp 3180] 
[FextWrap|[p 3189] 
[Theme][p 3198] 
[ThemeColorName][p 3207] 
[ThemefconName][p 3216] 
[ThemeSizeName][p 3225] 
[ThemeVarianf][p 3234] 
[URI|[p 3243] 
[URTReadCTosey|[p 3253] 
[URIWriteCToser|[p 3262] 
[Validatable][p 32711 
[Vector2][p 3280] 
[Widget|[p 3289] 
[WidgetRenderer|[p 3298) 

e [Window][p 3307] 
O [appl [p 3318] 

© [package appl[p 3318] 

e [SettingsSchema][p 3328] 
O [canvas][p 3337] 

© [package canvas) [p 3337] 

e |Circle][p 3347] 

e [Image][p 3357] 

e [ImageFill] [p 3369] 

© [ImageScale][p 3378] 

e 

e 


[Line] [p 3387] 
[p 3397] 
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© [ToolbarSpacei|[p 4993] 
e [Tree|[p 5002] 
 [TreeNodelD][p 5014] 

© [List My Applip 5023] 


Fyne API "theme" 


theme 


import "fyne.io/fyne/v2/theme" 


Package theme defines how a Fyne app should look when rendered. 


Usage 


const ( 
// TconNameCancel is the name of theme lookup for cancel icon. 
// 
// Since: 2.0 
IconNameCancel fyne.ThemeIconName = "cancel" 


// TconNameConfirm is the name of theme lookup for confirm icon. 


// 
// Since: 2.0 
IconNameConfirm fyne.ThemeIconName = "confirm" 


// IconNameDelete is the name of theme lookup for delete icon. 


// 
// Since: 2.0 
IconNameDelete fyne.ThemeIconName = "delete" 


// TconNameSearch is the name of theme lookup for search icon. 


// 
// Since: 2.0 
IconNameSearch fyne.ThemeIconName = "search" 


// TconNameSearchReplace is the name of theme lookup for search and replace icon. 


// 
// Since: 2.0 
IconNameSearchReplace fyne.ThemeIconName = "searchReplace" 


// TIconNameMenu is the name of theme lookup for menu icon. 


// 
// Since: 2.0 
IconNameMenu fyne.ThemeIconName = "menu" 


// TconNameMenuExpand is the name of theme lookup for menu expansion icon. 


// 
// Since: 2.0 
IconNameMenuExpand fyne.ThemeIconName = "menuExpand" 


// TconNameCheckButtonChecked is the name of theme lookup for checked check button icon. 
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// 
// Since: 2.0 
IconNameCheckButtonChecked fyne.ThemeIconName = "checked" 


// TconNameCheckButton is the name of theme lookup for unchecked check button icon. 
// 

// Since: 2.0 

IconNameCheckButton fyne.ThemeIconName = "unchecked" 


// TconNameRadioButton is the name of theme lookup for radio button unchecked icon. 
// 

// Since: 2.0 

IconNameRadioButton fyne.ThemeIconName = "radioButton" 


// TconNameRadioButtonChecked is the name of theme lookup for radio button checked icon. 
// 

// Since: 2.0 

IconNameRadioButtonChecked fyne.ThemeIconName = "radioButtonChecked" 


// TconNameColorAchromatic is the name of theme lookup for greyscale color icon. 
// 

// Since: 2.0 

IconNameColorAchromatic fyne.ThemeIconName = "colorAchromatic" 


// TconNameColorChromatic is the name of theme lookup for full color icon. 
// 

// Since: 2.0 

IconNameColorChromatic fyne.ThemeIconName = "colorChromatic" 


// TconNameColorPalette is the name of theme lookup for color palette icon. 
// 

// Since: 2.0 

IconNameColorPalette fyne.ThemeIconName = "colorPalette" 


// TconNameContentAdd is the name of theme lookup for content add icon. 
// 

// Since: 2.0 
IconNameContentAdd fyne.ThemeIconName = "contentAdd" 


// TIconNameContentRemove is the name of theme lookup for content remove icon. 
// 

// Since: 2.0 
IconNameContentRemove fyne.ThemeIconName = "contentRemove" 


// TconNameContentCut is the name of theme lookup for content cut icon. 
// 

// Since: 2.0 
IconNameContentCut fyne.ThemeIconName = "contentCut" 


// TconNameContentCopy is the name of theme lookup for content copy icon. 
// 

// Since: 2.0 
IconNameContentCopy fyne.ThemeIconName = "contentCopy" 


// TconNameContentPaste is the name of theme lookup for content paste icon. 
// 

// Since: 2.0 
IconNameContentPaste fyne.ThemeIconName = "contentPaste" 


// TconNameContentClear is the name of theme lookup for content clear icon. 
// 

// Since: 2.0 
IconNameContentClear fyne.ThemeIconName = "contentClear" 
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// TconNameContentRedo is the name of theme lookup for content redo icon. 
// 

// Since: 2.0 
IconNameContentRedo fyne.ThemeIconName = "contentRedo" 


// IconNameContentUndo is the name of theme lookup for content undo icon. 
// 

// Since: 2.0 
IconNameContentUndo fyne.ThemeIconName = "contentUndo" 


// TconNameInfo is the name of theme lookup for info icon. 
// 

// Since: 2.0 

IconNameInfo fyne.ThemeIconName = "info" 


// TconNameQuestion is the name of theme lookup for question icon. 
// 

// Since: 2.0 

IconNameQuestion fyne.ThemeIconName = "question" 


// TconNameWarning is the name of theme lookup for warning icon. 
// 

// Since: 2.0 

IconNameWarning fyne.ThemeIconName = "warning" 


// TconNameError is the name of theme lookup for error icon. 
// 

// Since: 2.0 

IconNameError fyne.ThemeIconName = "error" 


// IconNameDocument is the name of theme lookup for document icon. 
// 

// Since: 2.0 

IconNameDocument fyne.ThemeIconName = "document" 


// TconNameDocumentCreate is the name of theme lookup for document create 
// 

// Since: 2.0 

IconNameDocumentCreate fyne.ThemeIconName = "documentCreate" 


icon. 


// TconNameDocumentPrint is the name of theme lookup for document print icon. 


// 
// Since: 2.0 
IconNameDocumentPrint fyne.ThemeIconName = "documentPrint" 


// TconNameDocumentSave is the name of theme lookup for document save icon. 


// 
// Since: 2.0 
IconNameDocumentSave fyne.ThemeIconName = "documentSave" 


// TconNameMoreHorizontal is the name of theme lookup for horizontal more. 


// 
// Since 2.0 
IconNameMoreHorizontal fyne.ThemeIconName = "moreHorizontal" 


// TconNameMoreVertical is the name of theme lookup for vertical more. 
// 

// Since 2.0 

IconNameMoreVertical fyne.ThemeIconName = "moreVertical" 


// TIconNameMailAttachment is the name of theme lookup for mail attachment 


// 
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icon. 


// Since: 2.0 
IconNameMailAttachment fyne.ThemeIconName = "mailAttachment" 


// TconNameMailCompose is the name of theme lookup for mail compose icon. 


// 
// Since: 2.0 
IconNameMailCompose fyne.ThemeIconName = "mailCompose" 


// TconNameMailForward is the name of theme lookup for mail forward icon. 


// 
// Since: 2.0 
IconNameMailForward fyne.ThemeIconName = "mailForward" 


// TIconNameMailReply is the name of theme lookup for mail reply icon. 


// 
// Since: 2.0 
IconNameMailReply fyne.ThemeIconName = "mailReply" 


// TconNameMailReplyAll is the name of theme lookup for mail reply-all icon. 


// 
// Since: 2.0 
IconNameMailReplyAll fyne.ThemeIconName = "mailReplyAll" 


// TIconNameMailSend is the name of theme lookup for mail send icon. 


// 

// Since: 2.0 

IconNameMailSend fyne.ThemeIconName = "mailSend" 

// TIconNameMediaMusic is the name of theme lookup for media music 
// 

// Since: 2.1 

IconNameMediaMusic fyne.ThemeIconName = "mediaMusic" 

// IconNameMediaPhoto is the name of theme lookup for media photo 
// 

// Since: 2.1 

IconNameMediaPhoto fyne.ThemeIconName = "mediaPhoto" 

// TconNameMediaVideo is the name of theme lookup for media video 
// 

// Since: 2.1 

IconNameMediaVideo fyne.ThemeIconName = "mediaVideo" 

// TIconNameMediaFastForward is the name of theme lookup for media 
// 

// Since: 2.0 

IconNameMediaFastForward fyne.ThemeIconName = "mediaFastForward" 


icon. 


icon. 


icon. 


fast-forward icon. 


// TconNameMediaFastRewind is the name of theme lookup for media fast-rewind icon. 


// 
// Since: 2.0 


IconNameMediaFastRewind fyne.ThemeIconName = "mediaFastRewind" 


// TconNameMediaPause is the name of theme lookup for media pause icon. 


// 
// Since: 2.0 
IconNameMediaPause fyne.ThemeIconName = "mediaPause" 


// TconNameMediaPlay is the name of theme lookup for media play icon. 


// 
// Since: 2.0 
IconNameMediaPlay fyne.ThemeIconName = "mediaPlay" 
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// TconNameMediaRecord is the name of theme lookup for media record icon. 
// 

// Since: 2.0 
IconNameMediaRecord fyne.ThemeIconName = "mediaRecord" 


// TconNameMediaReplay is the name of theme lookup for media replay icon. 
// 

// Since: 2.0 
IconNameMediaReplay fyne.ThemeIconName = "mediaReplay" 


// TIconNameMediaSkipNext is the name of theme lookup for media skip next icon. 
// 

// Since: 2.0 

IconNameMediaSkipNext fyne.ThemeIconName = "mediaSkipNext" 


// TconNameMediaSkipPrevious is the name of theme lookup for media skip previous icon. 
// 

// Since: 2.0 

IconNameMediaSkipPrevious fyne.ThemeIconName = "mediaSkipPrevious" 


// TIconNameMediaStop is the name of theme lookup for media stop icon. 
// 

// Since: 2.0 

IconNameMediaStop fyne.ThemeIconName = "mediaStop" 


// IconNameMoveDown is the name of theme lookup for move down icon. 
// 

// Since: 2.0 

IconNameMoveDown fyne.ThemeIconName = "arrowDown" 


// TIconNameMoveUp is the name of theme lookup for move up icon. 


// 
// Since: 2.0 
IconNameMoveUp fyne.ThemeIconName = "arrowUp" 


// TconNameNavigateBack is the name of theme lookup for navigate back icon. 
// 

// Since: 2.0 

IconNameNavigateBack fyne.ThemeIconName = "arrowBack" 


// TconNameNavigateNext is the name of theme lookup for navigate next icon. 
// 

// Since: 2.0 

IconNameNavigateNext fyne.ThemeIconName = "arrowForward" 


// TconNameArrowDropDown is the name of theme lookup for drop-down arrow icon. 
// 

// Since: 2.0 

IconNameArrowDropDown fyne.ThemeIconName = "arrowDropDown" 


// IconNameArrowDropUp is the name of theme lookup for drop-up arrow icon. 
// 

// Since: 2.0 

IconNameArrowDropUp fyne.ThemeIconName = "arrowDropUp" 


// TconNameFile is the name of theme lookup for file icon. 


// 
// Since: 2.0 
IconNameFile fyne.ThemeIconName = "file" 


// IconNameFileApplication is the name of theme lookup for file application icon. 
// 
// Since: 2.0 


4385 


IconNameFileApplication fyne.ThemeIconName = "fileApplication" 


// TconNameFileAudio is the name of theme lookup for file audio icon. 
// 

// Since: 2.0 
IconNameFileAudio fyne.ThemeIconName = "fileAudio" 


// TconNameFileImage is the name of theme lookup for file image icon. 
// 

// Since: 2.0 
IconNameFileImage fyne.ThemeIconName = "fileImage" 


// TconNameFileText is the name of theme lookup for file text icon. 
// 

// Since: 2.0 

IconNameFileText fyne.ThemeIconName = "fileText" 


// TconNameFileVideo is the name of theme lookup for file video icon. 
// 

// Since: 2.0 

IconNameFileVideo fyne.ThemeIconName = "fileVideo" 


// TconNameFolder is the name of theme lookup for folder icon. 
bf 

// Since: 2.0 

IconNameFolder fyne.ThemeIconName = "folder" 


// TconNameFolderNew is the name of theme lookup for folder new icon. 
// 

// Since: 2.0 

IconNameFolderNew fyne.ThemeIconName = "folderNew" 


// TconNameFolderOpen is the name of theme lookup for folder open icon. 
// 

// Since: 2.0 

IconNameFolderOpen fyne.ThemeIconName = "folderOpen" 


// IconNameHelp is the name of theme lookup for help icon. 
// 

// Since: 2.0 

IconNameHelp fyne.ThemeIconName = "help" 


// IconNameHistory is the name of theme lookup for history icon. 
// 

// Since: 2.0 

IconNameHistory fyne.ThemeIconName = "history" 


// IconNameHome is the name of theme lookup for home icon. 
// 

// Since: 2.0 

IconNameHome fyne.ThemeIconName = "home" 


// TconNameSettings is the name of theme lookup for settings icon. 
// 

// Since: 2.0 

IconNameSettings fyne.ThemeIconName = "settings" 


// IconNameStorage is the name of theme lookup for storage icon. 
// 
// Since: 2.0 


IconNameStorage fyne.ThemeIconName = "storage" 


// TconNameUpload is the name of theme lookup for upload icon. 
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// 
// Since: 2.0 
IconNameUpload fyne.ThemeIconName = "upload" 


// TconNameViewFullScreen is the name of theme lookup for view fullscreen icon. 
// 

// Since: 2.0 

IconNameViewFullScreen fyne.ThemeIconName = "viewFullScreen" 


// TIconNameViewRefresh is the name of theme lookup for view refresh icon. 
// 

// Since: 2.0 

IconNameViewRefresh fyne.ThemeIconName = "viewRefresh" 


// TconNameViewZoomFit is the name of theme lookup for view zoom fit icon. 
// 

// Since: 2.0 

IconNameViewZoomFit fyne.ThemeIconName = "viewZoomFit" 


// IconNameViewZoomIn is the name of theme lookup for view zoom in icon. 
// 

// Since: 2.0 

IconNameViewZoomIn fyne.ThemeIconName = "viewZoomIn" 


// TconNameViewZoomOut is the name of theme lookup for view zoom out icon. 
// 

// Since: 2.0 

IconNameViewZoomOut fyne.ThemeIconName = "viewZoomOut" 


// TconNameViewRestore is the name of theme lookup for view restore icon. 
// 

// Since: 2.0 

IconNameViewRestore fyne.ThemeIconName = "viewRestore" 


// TconNameVisibility is the name of theme lookup for visibility icon. 
// 

// Since: 2.0 

IconNameVisibility fyne.ThemeIconName = "visibility" 


// TconNameVisibilityOff is the name of theme lookup for invisibility icon. 
// 

// Since: 2.0 

IconNameVisibilityOff fyne.ThemeIconName = "visibilityoff" 


// TconNameVolumeDown is the name of theme lookup for volume down icon. 
// 

// Since: 2.0 

IconNameVolumeDown fyne.ThemeIconName = "volumeDown" 


// TconNameVolumeMute is the name of theme lookup for volume mute icon. 
// 

// Since: 2.0 

IconNameVolumeMute fyne.ThemeIconName = "volumeMute" 


// IconNameVolumeUp is the name of theme lookup for volume up icon. 
// 

// Since: 2.0 

IconNameVolumeUp fyne.ThemeIconName = "volumeUp" 


// TconNameDownload is the name of theme lookup for download icon. 
// 

// Since: 2.0 

IconNameDownload fyne.ThemeIconName = "download" 
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const 


// TIconNameComputer is the name of theme lookup for computer icon. 


// 
// Since: 2.0 


IconNameComputer fyne.ThemeIconName = "computer" 


// TconNameAccount is the name of theme lookup for account icon. 


// 
// Since: 2.1 


IconNameAccount fyne.ThemeIconName = "account" 


// TconNameLogin is the name of theme lookup for login icon. 


// 
// Since: 2.1 
IconNameLogin fyne.ThemeIconName = "login" 


// IconNameLogout is the name of theme lookup for logout icon. 


// 
// Since: 2.1 


IconNameLogout fyne.ThemeIconName = "logout" 


// TconNameList is the name of theme lookup for list icon. 


// 
// Since: 2.1 
IconNameList fyne.ThemeIconName = "list" 


// TconNameGrid is the name of theme lookup for grid icon. 


// 
// Since: 2.1 
IconNameGrid fyne.ThemeIconName = "grid" 


// ColorRed is the red primary color name. 


// 
// Since: 1.4 
ColorRed = "red" 


// ColorOrange is the orange primary color name. 
// 

// Since: 1.4 

ColorOrange = "orange" 

// ColorYellow is the yellow primary color name. 
// 

// Since: 1.4 

ColorYellow = "yellow" 

// ColorGreen is the green primary color name. 
// 

// Since: 1.4 

ColorGreen = "green" 

// ColorBlue is the blue primary color name. 

// 

// Since: 1.4 

ColorBlue = "blue" 

// ColorPurple is the purple primary color name. 
// 

// Since: 1.4 

ColorPurple = "purple" 

// ColorBrown is the brown primary color name. 
// 

// Since: 1.4 

ColorBrown = "brown" 

// ColorGray is the gray primary color name. 

// 

// Since: 1.4 

ColorGray = "gray" 


// ColorNameBackground is the name of theme lookup for 
// 

// Since: 2.0 

ColorNameBackground fyne.ThemeColorName = "background" 
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background color. 


// ColorNameButton is the name of theme lookup for button color. 


// 
// Since: 2.0 
ColorNameButton fyne.ThemeColorName = "button" 


// ColorNameDisabledButton is the name of theme lookup for disabled button color. 
// 

// Since: 2.0 

ColorNameDisabledButton fyne.ThemeColorName = "disabledButton" 


// ColorNameDisabled is the name of theme lookup for disabled foreground color. 
// 

// Since: 2.0 

ColorNameDisabled fyne.ThemeColorName = "disabled" 


// ColorNameError is the name of theme lookup for foreground error color. 
// 

// Since: 2.0 

ColorNameError fyne.ThemeColorName = "error" 


// ColorNameFocus is the name of theme lookup for focus color. 


// 
// Since: 2.0 
ColorNameFocus fyne.ThemeColorName = "focus" 


// ColorNameForeground is the name of theme lookup for foreground color. 
// 

// Since: 2.0 

ColorNameForeground fyne.ThemeColorName = "foreground" 


// ColorNameHover is the name of theme lookup for hover color. 


// 
// Since: 2.0 
ColorNameHover fyne.ThemeColorName = "hover" 


// ColorNameInputBackground is the name of theme lookup for background color of an input field. 


// 
// Since: 2.0 
ColorNameInputBackground fyne.ThemeColorName = "inputBackground" 


// ColorNamePlaceHolder is the name of theme lookup for placeholder text color. 
// 

// Since: 2.0 

ColorNamePlaceHolder fyne.ThemeColorName = "placeholder" 


// ColorNamePressed is the name of theme lookup for the tap overlay color. 
// 

// Since: 2.0 

ColorNamePressed fyne.ThemeColorName = "pressed" 


// ColorNamePrimary is the name of theme lookup for primary color. 


Tt 
// Since: 2.0 
ColorNamePrimary fyne.ThemeColorName = "primary" 


// ColorNameScrollBar is the name of theme lookup for scrollbar color. 


// 
// Since: 2.0 
ColorNameScrollBar fyne.ThemeColorName = "scrollBar" 


// ColorNameSelection is the name of theme lookup for selection color. 


// 
// Since: 2.1 
ColorNameSelection fyne.ThemeColorName = "selection" 


// ColorNameShadow is the name of theme lookup for shadow color. 


// 
// Since: 2.0 
ColorNameShadow fyne.ThemeColorName = "shadow" 


// SizeNameCaptionText is the name of theme lookup for helper text size, normally smaller than 
// 

// Since: 2.0 

SizeNameCaptionText fyne.ThemeSizeName = "helperText" 


// SizeNameInlineIcon is the name of theme lookup for inline icons size. 
// 

// Since: 2.0 

SizeNameInlineIcon fyne.ThemeSizeName = "iconInline" 
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regular text size. 


// SizeNamePadding is the name of theme lookup for padding size. 


// 
// Since: 2.0 
SizeNamePadding fyne.ThemeSizeName = "padding" 


// SizeNameScrollBar is the name of theme lookup for the scrollbar size. 


// 
// Since: 2.0 
SizeNameScrollBar fyne.ThemeSizeName = "scrollBar" 


// SizeNameScrollBarSmall is the name of theme lookup for the shrunk scrollbar size. 


// 
// Since: 2.0 
SizeNameScrollBarSmall fyne.ThemeSizeName = "scrollBarSmall" 


// SizeNameSeparatorThickness is the name of theme lookup for the thickness of a separator. 


// 
// Since: 2.0 
SizeNameSeparatorThickness fyne.ThemeSizeName = "separator" 


// SizeNameText is the name of theme lookup for text size. 


// 
// Since: 2.0 
SizeNameText fyne.ThemeSizeName = "text" 


// SizeNameHeadingText is the name of theme lookup for text size of a heading. 


// 
// Since: 2.1 
SizeNameHeadingText fyne.ThemeSizeName = "headingText" 


// SizeNameSubHeadingText is the name of theme lookup for text size of a sub-heading. 


// 
// Since: 2.1 
SizeNameSubHeadingText fyne.ThemeSizeName = "subHeadingText" 


// SizeNameInputBorder is the name of theme lookup for input border size. 


// 
// Since: 2.0 
SizeNameInputBorder fyne.ThemeSizeName = "inputBorder" 


// VariantDark is the version of a theme that satisfies a user preference for a light look. 


// 
// Since: 2.0 
VariantDark fyne.ThemeVariant = 0 


// VariantLight is the version of a theme that satisfies a user preference for a dark look. 
// 

// Since: 2.0 

VariantLight fyne.ThemeVariant = 1 


func AccountIcon 


func AccountIcon() fyne.Resource 


AccountIcon returns a resource containing the standard account icon for the current theme 


func BackgroundColor 


func BackgroundColor() color.Color 


BackgroundColor returns the themeas background color. 
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func ButtonColor 


func ButtonColor() color.Color 

ButtonColor returns the themeas standard button color. 

func CancelIcon 

func CancellIcon() fyne.Resource 

Cancellcon returns a resource containing the standard cancel icon for the current theme 
func CaptionTextSize 

func CaptionTextSize() float32 

CaptionTextSize returns the size for caption text. 

func CheckButtonCheckedIcon 

func CheckButtonCheckedIcon() fyne.Resource 


CheckButtonCheckedlIcon returns a resource containing the standard checkbox checked icon for the 
current theme 


func CheckButtonIcon 

func CheckButtonIcon() fyne.Resource 

CheckButtonIcon returns a resource containing the standard checkbox icon for the current theme 
func ColorAchromaticlIcon 

func ColorAchromaticIcon() fyne.Resource 


ColorAchromaticlcon returns a resource containing the standard achromatic color icon for the current 
theme 


func ColorChromaticIcon 


func ColorChromaticIcon() fyne.Resource 


ColorChromaticIcon returns a resource containing the standard chromatic color icon for the current theme 


func ColorPaletteIcon 


func ColorPaletteIcon() fyne.Resource 


ColorPaletteIcon returns a resource containing the standard color palette icon for the current theme 
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func ComputerIcon 


func ComputerIcon() fyne.Resource 


Computerlcon returns a resource containing the standard computer icon for the current theme 


func ConfirmIcon 


func ConfirmIcon() fyne.Resource 


Confirmlcon returns a resource containing the standard confirm icon for the current theme 


func ContentAddIcon 


func ContentAddiIcon() fyne.Resource 


ContentAddIcon returns a resource containing the standard content add icon for the current theme 


func ContentClearIcon 


func ContentClearIcon() fyne.Resource 


ContentClearlIcon returns a resource containing the standard content clear icon for the current theme 


func ContentCopylcon 


func ContentCopylIcon() fyne.Resource 


ContentCopylcon returns a resource containing the standard content copy icon for the current theme 


func ContentCutIcon 


func ContentCutIcon() fyne.Resource 


ContentCutlIcon returns a resource containing the standard content cut icon for the current theme 


func ContentPasteIcon 


func ContentPasteIcon() fyne.Resource 


ContentPastelcon returns a resource containing the standard content paste icon for the current theme 


func ContentRedolcon 


func ContentRedolIcon() fyne.Resource 


ContentRedolcon returns a resource containing the standard content redo icon for the current theme 
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func ContentRemovelcon 


func ContentRemovelIcon() fyne.Resource 


ContentRemovelcon returns a resource containing the standard content remove icon for the current theme 


func ContentUndolcon 


func ContentUndolIcon() fyne.Resource 


ContentUndolcon returns a resource containing the standard content undo icon for the current theme 


func DarkTheme 


func DarkTheme() fyne.Theme 
DarkTheme defines the built-in dark theme colors and sizes. 


Deprecated: This method ignores user preference and should not be used, it will be removed in v3.0. 


func DefaultSymbolFont 


func DefaultSymbolFont() fyne.Resource 
DefaultSymbolFont returns the font resource for the built-in symbol font. 


Since: 2.2 


func DefaultTextBoldFont 


func DefaultTextBoldFont() fyne.Resource 


DefaultTextBoldFont returns the font resource for the built-in bold font style. 


func DefaultTextBoldItalicFont 


func DefaultTextBoldItalicFont() fyne.Resource 


DefaultTextBoldItalicFont returns the font resource for the built-in bold and italic font style. 


func DefaultTextFont 


func DefaultTextFont() fyne.Resource 


DefaultTextFont returns the font resource for the built-in regular font style. 


func DefaultTextItalicFont 


func DefaultTextItalicFont() fyne.Resource 
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DefaultTextItalicFont returns the font resource for the built-in italic font style. 


func DefaultTextMonospaceF ont 
func DefaultTextMonospaceFont() fyne.Resource 
DefaultTextMonospaceFont returns the font resource for the built-in monospace font face. 


func DefaultTheme 


func DefaultTheme() fyne.Them 


DefaultTheme returns a built-in theme that can adapt to the user preference of light or dark colors. 


Since: 2.0 


func DeleteIcon 


func DeleteIcon() fyne.Resource 


DeleteIcon returns a resource containing the standard delete icon for the current theme 


func DisabledButtonColor 


func DisabledButtonColor() color.Color 


DisabledButtonColor returns the themeas disabled button color. 


func DisabledColor 


func DisabledColor() color.Color 
DisabledColor returns the foreground color for a disabled UI element. 


Since: 2.0 


func DisabledTextColor 


func DisabledTextColor() color.Color 
DisabledTextColor returns the themeds disabled text color - this is actually the disabled color since 1.4. 


Deprecated: Use theme.DisabledColor() colour instead. 


func DocumentCreatelcon 


func DocumentCreateIcon() fyne.Resource 


DocumentCreatelIcon returns a resource containing the standard document create icon for the current 
theme 
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func DocumentIcon 


func DocumentIcon() fyne.Resource 


Documentlcon returns a resource containing the standard document icon for the current theme 


func DocumentPrintIcon 


func DocumentPrintIcon() fyne.Resource 


DocumentPrintIcon returns a resource containing the standard document print icon for the current theme 


func DocumentSavelcon 


func DocumentSavelIcon() fyne.Resource 


DocumentSavelcon returns a resource containing the standard document save icon for the current theme 


func DownloadIcon 


func DownloadiIcon() fyne.Resource 


DownloadIcon returns a resource containing the standard download icon for the current theme 


func ErrorColor 


func ErrorColor() color.Color 
ErrorColor returns the themeas error text color. 


Since: 2.0 


func ErrorIcon 


func ErrorIcon() fyne.Resource 


Errorlcon returns a resource containing the standard dialog error icon for the current theme 


func FileA pplicationIcon 


func FileApplicationIcon() fyne.Resource 


FileApplicationIcon returns a resource containing the file icon representing application files for the current 
theme 


func FileAudioIcon 


func FileAudiolIcon() fyne.Resource 
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FileAudiolcon returns a resource containing the file icon representing audio files for the current theme 


func FileIcon 


func FileIcon() fyne.Resource 


FileIcon returns a resource containing the appropriate file icon for the current theme 


func FileImageIcon 


func FileImageIcon() fyne.Resource 


FileImagelcon returns a resource containing the file icon representing image files for the current theme 


func FileTextIcon 


func FileTextIcon() fyne.Resource 


FileTextIcon returns a resource containing the file icon representing text files for the current theme 


func FileVideoIcon 


func FileVideoIcon() fyne.Resource 


File Videolcon returns a resource containing the file icon representing video files for the current theme 


func FocusColor 


func FocusColor() color.Color 


FocusColor returns the color used to highlight a focused widget. 


func FolderIcon 


func FolderIcon() fyne.Resource 


FolderIcon returns a resource containing the standard folder icon for the current theme 


func FolderNewlIcon 


func FolderNewIcon() fyne.Resource 


FolderNewlIcon returns a resource containing the standard folder creation icon for the current theme 


func FolderOpenIcon 


func FolderOpeniIcon() fyne.Resource 


FolderOpenlcon returns a resource containing the standard folder open icon for the current theme 
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func ForegroundColor 


func ForegroundColor() color.Color 

ForegroundColor returns the themeds standard foreground color for text and icons. 
Since: 2.0 

func From JSON 

func FromJSON(data string) (fyne.Theme, error) 


FromJSON returns a Theme created from the given JSON metadata. Any values not present in the data 
will fall back to the default theme. If a parse error occurs it will be returned along with a default theme. 


Since: 2.2 
func FromJSONReader 
func FromJSONReader(r io.Reader) (fyne.Theme, error) 


FromJSONReader returns a Theme created from the given JSON metadata through the reader. Any values 
not present in the data will fall back to the default theme. If a parse error occurs it will be returned along 
with a default theme. 


Since: 2.2 


func FromLegacy 


func FromLegacy(t fyne.LegacyTheme) fyne.Them 


FromLegacy returns a 2.0 Theme created from the given LegacyTheme data. This is a transition path and 
will be removed in the future (probably version 3.0). 


Since: 2.0 


func FyneLogo 


func FyneLogo() fyne.Resource 


FyneLogo returns a resource containing the Fyne logo 


func GridIcon 


func GridIcon() fyne.Resource 


GridIcon returns a resource containing the standard grid icon for the current theme 
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func HelpIcon 


func HelpIcon() fyne.Resource 

HelpIcon returns a resource containing the standard help icon for the current theme 

func HistoryIcon 

func HistoryIcon() fyne.Resource 

HistoryIcon returns a resource containing the standard history icon for the current theme 
func Homelcon 

func HomeIcon() fyne.Resource 

Homelcon returns a resource containing the standard home folder icon for the current theme 
func HoverColor 

func HoverColor() color.Color 


HoverColor returns the color used to highlight interactive elements currently under a cursor. 


func IconInlineSize 


func IconInlineSize() float32 


IconInlineSize is the standard size of icons which appear within buttons, labels etc. 


func InfoIcon 

func InfolIcon() fyne.Resource 

Infolcon returns a resource containing the standard dialog info icon for the current theme 
func InputBackgroundColor 

func InputBackgroundColor() color.Color 

InputBackgroundColor returns the color used to draw underneath input elements. 

func InputBorderSize 

func InputBorderSize() float32 

InputBorderSize returns the input border size (or underline size for an entry). 


Since: 2.0 
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func LightTheme 


func LightTheme() fyne.Them 


LightTheme defines the built-in light theme colors and sizes. 


Deprecated: This method ignores user preference and should not be used, it will be removed in v3.0. 


func ListIcon 


func ListIcon() fyne.Resource 


ListIcon returns a resource containing the standard list icon for the current theme 


func LoginIcon 


func LoginIcon() fyne.Resource 


LoginIcon returns a resource containing the standard login icon for the current theme 


func LogoutIcon 


func LogoutIcon() fyne.Resource 


Logoutlcon returns a resource containing the standard logout icon for the current theme 


func MailAttachmentIcon 


func MailAttachmentIcon() fyne.Resource 


MailAttachmentlcon returns a resource containing the standard mail attachment icon for the current theme 


func MailComposelcon 


func MailComposelIcon() fyne.Resource 


MailComposelcon returns a resource containing the standard mail compose icon for the current theme 


func MailForwardIcon 


func MailForwardiIcon() fyne.Resource 


MailForwardIcon returns a resource containing the standard mail forward icon for the current theme 


func MailReplyAllicon 


func MailReplyAllicon() fyne.Resource 


MailReplyAllIcon returns a resource containing the standard mail reply all icon for the current theme 
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func MailReplyIcon 


func MailReplyIcon() fyne.Resource 

MailReplyIcon returns a resource containing the standard mail reply icon for the current theme 
func MailSendIcon 

func MailSendIcon() fyne.Resource 


MailSendIcon returns a resource containing the standard mail send icon for the current theme 


func MediaFastForwardIcon 


func MediaFastForwardIcon() fyne.Resource 


MediaFastForwardIcon returns a resource containing the standard media fast-forward icon for the current 
theme 


func MediaFastRewindIcon 
func MediaFastRewindIcon() fyne.Resource 


MediaFastRewindIcon returns a resource containing the standard media fast-rewind icon for the current 
theme 


func MediaMusiclcon 
func MediaMusicIcon() fyne.Resource 
MediaMusiclIcon returns a resource containing the standard media music icon for the current theme 


Since: 2.1 


func MediaPauselcon 

func MediaPauselIcon() fyne.Resource 

MediaPauselcon returns a resource containing the standard media pause icon for the current theme 
func MediaPhotolIcon 

func MediaPhotolIcon() fyne.Resource 

MediaPhotolcon returns a resource containing the standard media photo icon for the current theme 


Since: 2.1 
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func MediaPlayIcon 


func MediaPlaylIcon() fyne.Resource 

MediaPlayIcon returns a resource containing the standard media play icon for the current theme 
func MediaRecordIcon 

func MediaRecordiIcon() fyne.Resource 

MediaRecordIcon returns a resource containing the standard media record icon for the current theme 
func MediaReplaylcon 

func MediaReplaylIcon() fyne.Resource 

MediaReplaylIcon returns a resource containing the standard media replay icon for the current theme 
func MediaSkipNextIcon 

func MediaSkipNextIcon() fyne.Resource 


MediaSkipNextIcon returns a resource containing the standard media skip next icon for the current theme 


func MediaSkipPreviousIcon 


func MediaSkipPreviousIcon() fyne.Resource 


MediaSkipPreviousIcon returns a resource containing the standard media skip previous icon for the 
current theme 


func MediaStopIcon 


func MediaStopIcon() fyne.Resource 


MediaStopIcon returns a resource containing the standard media stop icon for the current theme 


func MediaVideolIcon 


func MediaVideolIcon() fyne.Resource 
MediaVideolcon returns a resource containing the standard media video icon for the current theme 


Since: 2.1 


func MenuDropDownIcon 


func MenuDropDownIcon() fyne.Resource 
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MenuDropDownlcon returns a resource containing the standard menu drop down icon for the current 
theme 


func MenuDropUpIcon 


func MenuDropUpicon() fyne.Resource 


MenuDropUplcon returns a resource containing the standard menu drop up icon for the current theme 


func MenuExpandIcon 


func MenuExpandiIcon() fyne.Resource 


MenuExpandiIcon returns a resource containing the standard (mobile) expand asubmenu icon for the 
current theme 


func Menulcon 


func MenulIcon() fyne.Resource 


Menulcon returns a resource containing the standard (mobile) menu icon for the current theme 


func MoreHorizontalIcon 


func MoreHorizontallIcon() fyne.Resource 


MoreHorizontallcon returns a resource containing the standard horizontal more icon for the current theme 


func MoreVerticallIcon 


func MoreVerticallIcon() fyne.Resource 


MoreVerticallcon returns a resource containing the standard vertical more icon for the current theme 


func MoveDownlIcon 


func MoveDownIcon() fyne.Resource 


MoveDownlcon returns a resource containing the standard down arrow icon for the current theme 


func MoveUpIcon 


func MoveUpIcon() fyne.Resource 


MoveUplIcon returns a resource containing the standard up arrow icon for the current theme 
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func NavigateBackIcon 


func NavigateBackIcon() fyne.Resource 


NavigateBackIcon returns a resource containing the standard backward navigation icon for the current 
theme 


func NavigateNextIcon 
func NavigateNextIcon() fyne.Resource 


NavigateNextIcon returns a resource containing the standard forward navigation icon for the current theme 


func Padding 


func Padding() float32 


Padding is the standard gap between elements and the border around interface elements. 


func PlaceHolderColor 


func PlaceHolderColor() color.Color 

PlaceHolderColor returns the themeas standard text color. 

func PressedColor 

func PressedColor() color.Color 

PressedColor returns the color used to overlap tapped features. 
Since: 2.0 

func PrimaryColor 

func PrimaryColor() color.Color 

PrimaryColor returns the color used to highlight primary features. 
func PrimaryColorNamed 

func PrimaryColorNamed(name string) color.Color 
PrimaryColorNamed returns a theme specific color value for a named primary color. 


Since: 1.4 
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func PrimaryColorNames 


func PrimaryColorNames() []string 

PrimaryColorNames returns a list of the standard primary color options. 
Since: 1.4 

func QuestionIcon 

func QuestionIcon() fyne.Resource 


QuestionIcon returns a resource containing the standard dialog question icon for the current theme 


func RadioButtonCheckedIcon 


func RadioButtonCheckedIcon() fyne.Resource 


RadioButtonCheckedIcon returns a resource containing the standard radio button checked icon for the 
current theme 


func RadioButtonIcon 


func RadioButtonIcon() fyne.Resource 


RadioButtonIcon returns a resource containing the standard radio button icon for the current theme 


func ScrollBarColor 


func ScrollBarColor() color.Color 


Scrol/BarColor returns the color (and translucency) for a scrollBar. 


func ScrollBarSize 


func ScrollBarSize() float32 


ScrollBarSize is the width (or height) of the bars on a ScrollContainer. 


func ScrollBarSmallSize 


func ScrollBarSmallSize() float32 


ScrollBarSmallSize is the width (or height) of the minimized bars on a ScrollContainer. 


func SearchIcon 


func SearchIcon() fyne.Resource 
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SearchIcon returns a resource containing the standard search icon for the current theme 
func SearchReplaceIcon 
func SearchReplacelIcon() fyne.Resource 


SearchReplacelcon returns a resource containing the standard search and replace icon for the current 
theme 


func SelectionColor 

func SelectionColor() color.Color 

SelectionColor returns the color for a selected element. 

Since: 2.1 

func SeparatorThicknessSize 

func SeparatorThicknessSize() float32 

SeparatorThicknessSize is the standard thickness of the separator widget. 

Since: 2.0 

func SettingsIcon 

func SettingsIcon() fyne.Resource 

SettingsIcon returns a resource containing the standard settings icon for the current theme 
func ShadowColor 

func ShadowColor() color.Color 

ShadowColor returns the color (and translucency) for shadows used for indicating elevation. 
func StoragelIcon 

func StorageIcon() fyne.Resource 

Storagelcon returns a resource containing the standard storage icon for the current theme 
func TextBoldFont 

func TextBoldFont() fyne.Resource 


TextBoldFont returns the font resource for the bold font style. 
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func TextBoldItalicFont 


func TextBoldItalicFont() fyne.Resource 


TextBoldItalicFont returns the font resource for the bold and italic font style. 


func TextColor 


func TextColor() color.Color 
TextColor returns the themeas standard text color - this is actually the foreground color since 1.4. 


Deprecated: Use theme.ForegroundColor() colour instead. 


func TextFont 


func TextFont() fyne.Resource 


TextFont returns the font resource for the regular font style. 


func TextHeadingSize 


func TextHeadingSize() float32 
TextHeadingSize returns the text size for header text. 


Since: 2.1 


func TextItalicFont 


func TextItalicFont() fyne.Resource 


TextItalicFont returns the font resource for the italic font style. 


func TextMonospaceFont 


func TextMonospaceFont() fyne.Resource 


TextMonospaceFont returns the font resource for the monospace font face. 


func TextSize 


func TextSize() float32 


TextSize returns the standard text size. 


func TextSubHeadingSize 


func TextSubHeadingSize() float32 
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TextSubHeadingSize returns the text size for sub-header text. 

Since: 2.1 

func UploadIcon 

func UploadiIcon() fyne.Resource 

UploadIcon returns a resource containing the standard upload icon for the current theme 

func ViewFullScreenIcon 

func ViewFullScreenIcon() fyne.Resource 

ViewFullScreenIcon returns a resource containing the standard fullscreen icon for the current theme 
func ViewRefreshIcon 

func ViewRefreshIcon() fyne.Resource 

ViewRefreshIcon returns a resource containing the standard refresh icon for the current theme 
func ViewRestoreIcon 

func ViewRestorelIcon() fyne.Resource 

ViewRestorelcon returns a resource containing the standard exit fullscreen icon for the current theme 
func VisibilityIcon 

func VisibilitylIcon() fyne.Resource 

VisibilityIcon returns a resource containing the standard visibility icon for the current theme 

func VisibilityOfflcon 

func VisibilityoffIcon() fyne.Resource 

VisibilityOfflcon returns a resource containing the standard visibility off icon for the current theme 
func VolumeDownIcon 

func VolumeDownIcon() fyne.Resource 

VolumeDownlcon returns a resource containing the standard volume down icon for the current theme 


func VolumeMutelIcon 


func VolumeMutelIcon() fyne.Resource 
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VolumeMutelcon returns a resource containing the standard volume mute icon for the current theme 
func VolumeUpIcon 

func VolumeUpIcon() fyne.Resource 

VolumeUplIcon returns a resource containing the standard volume up icon for the current theme 
func WarningIcon 

func WarningIcon() fyne.Resource 

WarningIcon returns a resource containing the standard dialog warning icon for the current theme 
func ZoomFitIcon 

func ZoomFitIcon() fyne.Resource 

ZoomFitIcon returns a resource containing the standard zoom fit icon for the current theme 

func ZoomInIcon 

func ZoomInIcon() fyne.Resource 

ZoomlnIcon returns a resource containing the standard zoom in icon for the current theme 

func ZoomOutIcon 

func ZoomOutIcon() fyne.Resource 


ZoomOutlcon returns a resource containing the standard zoom out icon for the current theme 
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Fyne API "theme.DisabledResource"' 


theme.DisabledResource 


import "fyne.io/fyne/v2/theme" 


Usage 


type DisabledResource 


type DisabledResource struct { 


} 


DisabledResource is a resource wrapper that will return an appropriate resource colorized by the current 
themeads DisabledColor color. 


func NewDisabledResource 


func NewDisabledResource(res fyne.Resource) *DisabledResource 


NewDisabledResource creates a resource that adapts to the current themeas DisabledColor setting. 


func (*DisabledResource) Content 


func (res *DisabledResource) Content() []byte 


Content returns the disabled style content of the correct resource for the current theme 


func (*DisabledResource) Name 


func (res *DisabledResource) Name() string 


Name returns the resource source name prefixed with disabled_ (used for caching) 
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theme.ErrorThemedResource 


import "fyne.io/fyne/v2/theme" 


Usage 


type ErrorThemedResource 


type 
} 


ErrorThemedResource struct { 


ErrorThemedResoutrce is a resource wrapper that will return a version of the resource with the main color 
changed to indicate an error. 


func NewErrorThemedResource 


func NewErrorThemedResource (orig fyne.Resource) *ErrorThemedResource 


NewErrorThemedResoutrce creates a resource that adapts to the error color for the current theme. 


func (*ErrorThemedResource) Content 


func 


(res *ErrorThemedResource) Content() []byte 


Content returns the underlying content of the resource adapted to the current background color. 


func (*ErrorThemedResource) Name 


func 


(res *ErrorThemedResource) Name() string 


Name returns the underlying resource name (used for caching). 


func (*ErrorThemedResource) Original 


func 


(res *ErrorThemedResource) Original() fyne.Resource 
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Original returns the underlying resource that this error themed resource was adapted from 
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Fyne API "theme.InvertedThemedResource"' 


theme.Inverted Themed Resource 


import "fyne.io/fyne/v2/theme" 


Usage 


type InvertedThemedResource 


type InvertedThemedResource struct { 
} 


InvertedThemedResource is a resource wrapper that will return a version of the resource with the main 
color changed for use over highlighted elements. 


func NewInvertedThemedResource 


func NewInvertedThemedResource (orig fyne.Resource) *InvertedThemedResourc 


NewlInvertedThemedResource creates a resource that adapts to the current theme for use over highlighted 
elements. 


func (*InvertedThemedResource) Content 


func (res *InvertedThemedResource) Content() []byte 


Content returns the underlying content of the resource adapted to the current background color. 


func (*InvertedThemedResource) Name 


func (res *InvertedThemedResource) Name() string 


Name returns the underlying resource name (used for caching). 
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func (*InvertedThemedResource) Original 


func (res *InvertedThemedResource) Original() fyne.Resource 


Original returns the underlying resource that this inverted themed resource was adapted from 
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Fyne API "theme.Primary ThemedResource" 


theme.Primary ThemedResource 


import "fyne.io/fyne/v2/theme" 


Usage 


type PrimaryThemedResource 


type PrimaryThemedResource struct { 


} 


PrimaryThemedResource is a resource wrapper that will return a version of the resource with the main 
color changed to the theme primary color. 


func NewPrimary Themed Resource 


func NewPrimaryThemedResource (orig fyne.Resource) *PrimaryThemedResource 


NewPrimaryThemedResource creates a resource that adapts to the primary color for the current theme. 


func (*PrimaryThemedResource) Content 


func (res *PrimaryThemedResource) Content() []byte 


Content returns the underlying content of the resource adapted to the current background color. 


func (*PrimaryThemedResource) Name 


func (res *PrimaryThemedResource) Name() string 


Name returns the underlying resource name (used for caching). 


func (*PrimaryThemedResource) Original 


func (res *PrimaryThemedResource) Original() fyne.Resource 
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Original returns the underlying resource that this primary themed resource was adapted from 
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Fyne API "theme. ThemedResource" 


theme. ThemedResource 


import "fyne.io/fyne/v2/theme" 


Usage 


type ThemedResource 


type ThemedResource struct { 
} 


ThemedResoutce is a resource wrapper that will return a version of the resource with the main color 
changed for the currently selected theme. 


func NewThemedResource 


func NewThemedResource (src fyne.Resource) *ThemedResourc 


NewThemedResource creates a resource that adapts to the current theme setting. 


func (*ThemedResource) Content 


func (res *ThemedResource) Content() []byte 


Content returns the underlying content of the resource adapted to the current text color. 


func (*ThemedResource) Error 


func (res *ThemedResource) Error() *ErrorThemedResource 


Error returns a different resource for indicating an error. 


func (*ThemedResource) Name 


func (res *ThemedResource) Name() string 
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Name returns the underlying resource name (used for caching). 
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Fyne API "widget"' 


widget 


import "fyne.io/fyne/v2/widget" 


Package widget defines the UI widgets within the Fyne toolkit. 


Usage 


var 


( 


// RichTextStyleBlockquote represents a quote presented in an 


RichTextStyleBlockquote = RichTextStyle{ 


// 

// Since: 2.1 
ColorName: 
Inline: 
SizeName: 
TextStyle: 


} 


theme .ColorNameForeground, 
false, 

theme.SizeNameText, 
fyne.TextStyle{Italic: true}, 


// RichTextStyleCodeBlock represents a code blog segment. 


RichTextStyleCodeBlock = RichTextStyle{ 


// 

// Since: 2.1 
ColorName: 
Inline: 
SizeName: 
TextStyle: 


} 


theme .ColorNameForeground, 
false, 
theme.SizeNameText, 

fyne.TextStyle{Monospace: true}, 


// RichTextStyleCodeInline represents an inline code segment. 


RichTextStyleCodeInline = RichTextStyle{ 


// 

// Since: 2.1 
ColorName: 
Inline: 
SizeName: 
TextStyle: 


} 


theme .ColorNameForeground, 
true, 
theme.SizeNameText, 

fyne.TextStyle{Monospace: true}, 


// RichTextStyleEmphasis represents regular text with emphasis. 


// 
// Since: 


2 


ol 


RichTextStyleEmphasis = RichTextStyle{ 


ColorName: 
Inline: 
SizeName: 
TextStyle: 


} 


theme .ColorNameForeground, 
true, 

theme.SizeNameText, 
fyne.TextStyle{Italic: true}, 


// RichTextStyleHeading represents a heading text that stands on its own 


// 
// Since: 


2 


wel. 
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indented block. 


line. 


RichTextStyleHeading = RichTextStyle{ 
ColorName: theme.ColorNameForeground, 
Inline: false, 
SizeName: theme.SizeNameHeadingText, 
TextStyle: fyne.TextStyle{Bold: true}, 
} 
// RichTextStyleInline represents standard text that can be surrounded by other elements. 
// 
// Since: 2.1 
RichTextStyleInline = RichTextStyle{ 
ColorName: theme.ColorNameForeground, 
Inline: true, 
SizeName: theme.SizeNameText, 
} 
// RichTextStyleParagraph represents standard text that should appear separate from other text. 
// 
// Since: 2.1 
RichTextStyleParagraph = RichTextStyle{ 
ColorName: theme.ColorNameForeground, 
Inline: false, 
SizeName: theme.SizeNameText, 


} 
// RichTextStylePassword represents standard sized text where the characters are obscured. 
// 
// Since: 2.1 
RichTextStylePassword = RichTextStyle{ 
ColorName: theme.ColorNameForeground, 
Inline: true, 
SizeName: theme.SizeNameText, 
} 
// RichTextStyleStrong represents regular text with a strong emphasis. 
// 
// Since: 2.1 
RichTextStyleStrong = RichTextStyle{ 
ColorName: theme.ColorNameForeground, 
Inline: true, 
SizeName: theme.SizeNameText, 
TextStyle: fyne.TextStyle{Bold: true}, 
} 
// RichTextStyleSubHeading represents a sub-heading text that stands on its own line. 
// 
// Since: 2.1 
RichTextStyleSubHeading = RichTextStyle{ 
ColorName: theme.ColorNameForeground, 
Inline: false, 
SizeName: theme.SizeNameSubHeadingText, 
TextStyle: fyne.TextStyle{Bold: true}, 


func NewSimpleRenderer 


func NewSimpleRenderer (object fyne.CanvasObject) fyne.WidgetRenderer 
NewSimpleRenderer creates a new SimpleRenderer to render a widget using a single fyne.CanvasObject. 


Since: 2.1 
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func ShowModalPopUp 


func ShowModalPopUp (content fyne.CanvasObject, canvas fyne.Canvas) 


ShowModalPopUp creates a new popUp for the specified content and displays it on the passed canvas. A 
modal PopUp blocks interactions with underlying elements, covered with a semi-transparent overlay. 


func ShowPopUp 


func ShowPopUp(content fyne.CanvasObject, canvas fyne.Canvas) 


ShowPopUp creates a new popUp for the specified content and displays it on the passed canvas. 


func ShowPopUpAtPosition 


func ShowPopUpAtPosition(content fyne.CanvasObject, canvas fyne.Canvas, pos fyne.Position) 


ShowPopUpAtPosition creates a new popUp for the specified content at the specified absolute position. It 
will then display the popup on the passed canvas. 


func ShowPopUpMenuAtPosition 


func ShowPopUpMenuAtPosition(menu *fyne.Menu, c fyne.Canvas, pos fyne.Position) 


ShowPopUpMenuAtPosition creates a PopUp menu populated with items from the passed menu structure. 
It will automatically be positioned at the provided location and shown as an overlay on the specified 
canvas. 
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© [List My Applip 5023} 


Fyne API ''widget.Accordion" 


widget.Accordion 


import "fyne.io/fyne/v2/widget" 


Usage 


type Accordion 
type Accordion struct { 
BaseWidget 
Items [] *AccordionItem 


MultiOpen bool 
} 


Accordion displays a list of AccordionItems. Each item is represented by a button that reveals a detailed 
view when tapped. 


func NewAccordion 


func NewAccordion(items ...*AccordionItem) *Accordion 


NewdAccordion creates a new accordion widget. 


func (*Accordion) Append 


func (a *Accordion) Append(item *AccordionItem) 


Append adds the given item to this Accordion. 


func (*Accordion) Close 


func (a *Accordion) Close(index int) 


Close collapses the item at the given index. 
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func (*Accordion) CloseAll 


func (a *Accordion) CloseAll() 


CloseAll collapses all items. 


func (*Accordion) CreateRenderer 


func (a *Accordion) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Accordion) MinSize 

func (a *Accordion) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below. 
func (*Accordion) Open 

func (a *Accordion) Open(index int) 

Open expands the item at the given index. 

func (*Accordion) OpenAll 

func (a *Accordion) OpenAll1 () 

OpenAll expands all items. 

func (*Accordion) Remove 

func (a *Accordion) Remove(item *AccordionItem) 
Remove deletes the given item from this Accordion. 


func (*Accordion) RemovelIndex 


func (a *Accordion) RemoveIndex (index int) 


Removelndex deletes the item at the given index from this Accordion. 
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widget.AccordionItem 


import "fyne.io/fyne/v2/widget" 


Usage 


type AccordionItem 


type AccordionItem struct { 
Title string 
Detail fyne.CanvasObject 
Open bool 
} 
AccordionItem represents a single item in an Accordion. 
func NewAccordionItem 
func NewAccordionItem(title string, detail fyne.CanvasObject) *AccordionItem 
NewAccordionItem creates a new item for an Accordion. 
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Fyne API ''widget.Base Widget" 


widget.Base Widget 


import "fyne.io/fyne/v2/widget" 


Usage 
type BaseWidget 


type BaseWidget struct { 
Hidden bool 
} 


BaseWidget provides a helper that handles basic widget behaviours. 


func (*BaseWidget) ExtendBase Widget 


func (w *BaseWidget) ExtendBaseWidget (wid fyne.Widget) 


ExtendBaseWidget is used by an extending widget to make use of Base Widget functionality. 
func (*BaseWidget) Hide 

func (w *BaseWidget) Hide() 

Hide this widget so it is no longer visible 

func (*BaseWidget) MinSize 

func (w *BaseWidget) MinSize() fyne.Size 


MinSize for the widget - it should never be resized below this value. 


func (*BaseWidget) Move 


func (w *BaseWidget) Move(pos fyne.Position) 
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Move the widget to a new position, relative to its parent. Note this should not be used if the widget is 
being managed by a Layout within a Container. 


func (*BaseWidget) Position 
func (w *BaseWidget) Position() fyne.Position 
Position gets the current position of this widget, relative to its parent. 


func (*BaseWidget) Refresh 


func (w *BaseWidget) Refresh () 


Refresh causes this widget to be redrawn in itas current state 


func (*BaseWidget) Resize 


func (w *BaseWidget) Resize(size fyne.Size) 


Resize sets a new size for a widget. Note this should not be used if the widget is being managed by a 
Layout within a Container. 


func (*BaseWidget) Show 


func (w *BaseWidget) Show() 


Show this widget so it becomes visible 


func (*BaseWidget) Size 


func (w *BaseWidget) Size() fyne.Siz 


Size gets the current size of this widget. 
func (*BaseWidget) Visible 
func (w *BaseWidget) Visible() bool 


Visible returns whether or not this widget should be visible. Note that this may not mean it is currently 
visible if a parent has been hidden. 
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widget.Button 


import "fyne.io/fyne/v2/widget" 


Usage 


type Button 


type Button struct { 
DisableableWidget 
Text string 
Icon fyne.Resource 
// Specify how prominent the button should be, High will highlight the button and Low will remove some decoration. 
// 
// Since: 1.4 


Importance ButtonImportance 
Alignment ButtonAlign 
IconPlacement ButtonIconPlacement 
OnTapped func() ‘json:"-"* 


Button widget has a text label and triggers an event func when clicked 


func NewButton 
func NewButton(label string, tapped func()) *Button 
NewButton creates a new button widget with the set label and tap handler 


func NewButtonWithIcon 


func NewButtonWithIcon(label string, icon fyne.Resource, tapped func()) *Button 


NewButtonWithIcon creates a new button widget with the specified label, themed icon and tap handler 


func (*Button) CreateRenderer 


func (b *Button) CreateRenderer() fyne.WidgetRenderer 
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CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Button) Cursor 


func (b *Button) Cursor() desktop.Cursor 


Cursor returns the cursor type of this widget 


func (*Button) FocusGained 


func (b *Button) FocusGained() 


FocusGained is a hook called by the focus handling logic after this object gained the focus. 


func (*Button) FocusLost 


func (b *Button) FocusLost () 


FocusLost is a hook called by the focus handling logic after this object lost the focus. 


func (*Button) MinSize 


func (b *Button) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 


func (*Button) MouseIn 


func (b *Button) MouseIn(*desktop.MouseEvent) 


Mouseln is called when a desktop pointer enters the widget 


func (*Button) MouseMoved 


func (b *Button) MouseMoved (*desktop.MouseEvent) 


MouseMoved is called when a desktop pointer hovers over the widget 


func (*Button) MouseOut 


func (b *Button) MouseOut () 


MouseOut is called when a desktop pointer exits the widget 


func (*Button) SetIcon 


func (b *Button) SetIcon(icon fyne.Resource) 


SetIcon updates the icon on a label - pass nil to hide an icon 
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func (*Button) SetText 


func (b *Button) SetText (text string) 


SetText allows the button label to be changed 


func (*Button) Tapped 


func (b *Button) Tapped (*fyne.PointEvent) 


Tapped is called when a pointer tapped event is captured and triggers any tap handler 


func (*Button) TypedKey 


func (b *Button) TypedKey (ev *fyne.KeyEvent) 


TypedKey is a hook called by the input handling logic on key events if this object is focused. 


func (*Button) TypedRune 


func (b *Button) TypedRune (rune) 
TypedRune is a hook called by the input handling logic on text input events if this object is focused. 
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widget.ButtonAlign 


import "fyne.io/fyne/v2/widget" 


Usage 


type ButtonAlign 


type ButtonAlign int 


ButtonAlign represents the horizontal alignment of a button. 


const ( 
// ButtonAlignCenter aligns the icon and the text centrally. 
ButtonAlignCenter ButtonAlign = iota 
// ButtonAlignLeading aligns the icon and the text with the leading edge. 
ButtonAlignLeading 
// ButtonAlignTrailing aligns the icon and the text with the trailing edge. 
ButtonAlignTrailing 

) 
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widget.ButtonIconPlacement 


import "fyne.io/fyne/v2/widget" 


Usage 


type ButtonIconPlacement 


type ButtonIconPlacement int 


ButtonIconPlacement represents the ordering of icon & text within a button. 


const ( 
// ButtonIconLeadingText aligns the icon on the leading edge of the text. 
ButtonIconLeadingText ButtonIconPlacement = iota 
// ButtonIconTrailingText aligns the icon on the trailing edge of the text. 
ButtonIconTrailingText 

) 
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widget.ButtonImportance 


import "fyne.io/fyne/v2/widget" 


Usage 


type ButtonImportance 


type ButtonImportance int 


ButtonImportance represents how prominent the button should appear 


Since: 1.4 

const ( 
// MediumImportance applies a standard appearance. 
MediumImportance ButtonImportance = iota 
// HighImportance applies a prominent appearance. 
HighImportance 
// LowImportance applies a subtle appearance. 
LowImportance 


) 
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widget.ButtonStyle 


import "fyne.io/fyne/v2/widget" 


Usage 


type ButtonStyle 
type ButtonStyle int 
ButtonStyle determines the behaviour and rendering of a button. 
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Fyne API ''widget.Card" 


widget.Card 


import "fyne.io/fyne/v2/widget" 


Usage 


type Card 
type Card struct { 
BaseWidget 
Title, Subtitle string 
Image *canvas.Image 
Content fyne.CanvasObject 


} 
Card widget groups title, subtitle with content and a header image 


Since: 1.4 


func NewCard 

func NewCard(title, subtitle string, content fyne.CanvasObject) *Card 
NewCard creates a new card widget with the specified title, subtitle and content (all optional). 
Since: 1.4 


func (*Card) CreateRenderer 


func (c *Card) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
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func (*Card) MinSize 


func (c *Card) MinSize() fyne.Size 

MinSize returns the size that this widget should not shrink below 
func (*Card) SetContent 

func (c *Card) SetContent (obj fyne.CanvasObject) 
SetContent changes the body of this card to have the specified content. 
func (*Card) SetImage 

func (c *Card) SetImage(img *canvas.Image) 

SetImage changes the image displayed above the title for this card. 
func (*Card) SetSubTitle 

func (c *Card) SetSubTitle(text string) 

SetSubTitle updates the secondary title for this card. 

func (*Card) SetTitle 

func (c *Card) SetTitle(text string) 

SetTitle updates the main title for this card. 
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Fyne API "'widget.Check"' 


widget.Check 


import "fyne.io/fyne/v2/widget" 


Usage 
type Check 


type Check struct { 
DisableableWidget 
Text string 
Checked bool 


OnChanged func(bool) ‘json:"-"* 
} 


Check widget has a text label and a checked (or unchecked) icon and triggers an event func when toggled 


func NewCheck 


func NewCheck (label string, changed func(bool)) *Check 


NewCheck creates a new check widget with the set label and change handler 


func NewCheckWithData 


func NewCheckWithData(label string, data binding.Bool) *Check 
NewCheckWithData returns a check widget connected with the specified data source. 


Since: 2.0 


func (*Check) Bind 


func (c *Check) Bind(data binding.Bool) 
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Bind connects the specified data source to this Check. The current value will be displayed and any 
changes in the data will cause the widget to update. User interactions with this Check will set the value 
into the data source. 


Since: 2.0 


func (*Check) CreateRenderer 


func (c *Check) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
func (*Check) FocusGained 

func (c *Check) FocusGained() 

FocusGained is called when the Check has been given focus. 
func (*Check) FocusLost 

func (c *Check) FocusLost () 

FocusLost is called when the Check has had focus removed. 
func (*Check) Hide 

func (c *Check) Hide () 

Hide this widget, if it was previously visible 

func (*Check) MinSize 

func (c *Check) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 


func (*Check) MouseIn 


func (c *Check) MouselIn(*desktop.MouseEvent) 


Mouseln is called when a desktop pointer enters the widget 


func (*Check) MouseMoved 


func (c *Check) MouseMoved (*desktop.MouseEvent) 


MouseMoved is called when a desktop pointer hovers over the widget 
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func (*Check) MouseOut 


func (c *Check) MouseOut () 
MouseOut is called when a desktop pointer exits the widget 


func (*Check) SetChecked 


func (c *Check) SetChecked(checked bool) 


SetChecked sets the the checked state and refreshes widget 


func (*Check) Tapped 


func (c *Check) Tapped(*fyne.PointEvent) 
Tapped is called when a pointer tapped event is captured and triggers any change handler 


func (*Check) TypedKey 


func (c *Check) TypedKey (key *fyne.KeyEvent) 


TypedKey receives key input events when the Check is focused. 
func (*Check) TypedRune 

func (c *Check) TypedRune(r rune) 

TypedRune receives text input events when the Check is focused. 
func (*Check) Unbind 

func (c *Check) Unbind() 


Unbind disconnects any configured data source from this Check. The current value will remain at the last 
value of the data source. 


Since: 2.0 
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Fyne API ''widget.CheckGroup" 


widget.CheckGroup 


import "fyne.io/fyne/v2/widget" 


Usage 
type CheckGroup 


type CheckGroup struct { 
DisableableWidget 
Horizontal bool 
Required bool 


OnChanged func([]string) ‘json:"-"* 
Options [] string 
Selected [] string 


} 


CheckGroup widget has a list of text labels and checkbox icons next to each. Changing the selection (any 
number can be selected) will trigger the changed func. 


Since: 2.1 


func NewCheckGroup 


func NewCheckGroup (options []string, changed func([]string)) *CheckGroup 
NewCheckGroup creates a new check group widget with the set options and change handler 


Since: 2.1 


func (*CheckGroup) Append 


func (r *CheckGroup) Append(option string) 


Append adds a new option to the end of a CheckGroup widget. 
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func (*CheckGroup) CreateRenderer 


func (r *CheckGroup) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
func (*CheckGroup) MinSize 
func (r *CheckGroup) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 


func (*CheckGroup) Refresh 


func (r *CheckGroup) Refresh () 
Refresh causes this widget to be redrawn in itas current state. 


Implements: fyne.CanvasObject 


func (*CheckGroup) SetSelected 


func (r *CheckGroup) SetSelected(options []string) 
SetSelected sets the checked options, it can be used to set a default option. 
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widget.CustomTextGridStyle 


import "fyne.io/fyne/v2/widget" 


Usage 


type CustomTextGridStyle 


type CustomTextGridStyle struct { 
FGColor, BGColor color.Color 
} 


CustomTextGridStyle is a utility type for those not wanting to define their own style types. 
func (*CustomTextGridStyle) BackgroundColor 

func (c *CustomTextGridStyle) BackgroundColor() color.Color 
BackgroundColor is the color a cell should use for the background. 

func (*CustomTextGridStyle) TextColor 

func (c *CustomTextGridStyle) TextColor() color.Color 

TextColor is the color a cell should use for the text. 
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Fyne API "widget.DisableableWidget" 


widget.DisableableWidget 


import "fyne.io/fyne/v2/widget" 


Usage 
type Disableable Widget 


type DisableableWidget struct { 
BaseWidget 
} 


DisableableWidget describes an extension to BaseWidget which can be disabled. Disabled widgets should 
have a visually distinct style when disabled, normally using theme.DisabledButtonColor. 


func (*DisableableWidget) Disable 


func (w *DisableableWidget) Disable () 


Disable this widget so that it cannot be interacted with, updating any style appropriately. 


func (*DisableableWidget) Disabled 


func (w *DisableableWidget) Disabled() bool 


Disabled returns true if this widget is currently disabled or false if it can currently be interacted with. 


func (*DisableableWidget) Enable 


func (w *DisableableWidget) Enable() 
Enable this widget, updating any style or features appropriately. 
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Fyne API "widget.Entry" 


widget.Entry 


import "fyne.io/fyne/v2/widget" 


Usage 


type Entry 


type Entry struct { 
DisableableWidget 


Text string 

// Since: 2.0 

TextStyle fyne.TextStyle 
PlaceHolder string 


OnChanged func(string) ‘json:"-"* 
// Since: 2.0 

OnSubmitted func(string) ‘json:"-"* 
Password bool 

MultiLine bool 

Wrapping fyne.TextWrap 


// Set a validator that this entry will check against 
// Since: 1.4 
Validator fyne.StringValidator ‘json:"-"* 


CursorRow, CursorColumn int 
OnCursorChanged func() ‘json:"-"* 


// ActionItem is a small item which is displayed at the outer right of the entry (like a password revealer) 
ActionItem fyne.CanvasObject ‘json:"-"* 


Entry widget allows simple text to be input when focused. 


func NewEntry 


func NewEntry() *Entry 


NewEntry creates a new single line entry widget. 
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func NewEntryWithData 


func NewEntryWithData(data binding.String) *Entry 
NewEntryWithData returns an Entry widget connected to the specified data source. 


Since: 2.0 


func NewMultiLineEntry 


func NewMultiLineEntry() *Entry 


NewMultiLineEntry creates a new entry that allows multiple lines 


func NewPasswordEntry 


func NewPasswordEntry() *Entry 


NewPasswordEntry creates a new entry password widget 


func (*Entry) AcceptsTab 


func (e *Entry) AcceptsTab() bool 
AcceptsTab returns if Entry accepts the Tab key or not. 


Implements: fyne.Tabbable 
Since: 2.1 


func (*Entry) Bind 


func (e *Entry) Bind(data binding.String) 


Bind connects the specified data source to this Entry. The current value will be displayed and any changes 
in the data will cause the widget to update. User interactions with this Entry will set the value into the data 
source. 


Since: 2.0 


func (*Entry) CreateRenderer 


func (e *Entry) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


Implements: fyne.Widget 
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func (*Entry) Cursor 


func (e *Entry) Cursor() desktop.Cursor 
Cursor returns the cursor type of this widget 


Implements: desktop.Cursorable 


func (*Entry) Disable 


func (e *Entry) Disable() 
Disable this widget so that it cannot be interacted with, updating any style appropriately. 
Implements: fyne.Disableable 


func (*Entry) Disabled 


func (e *Entry) Disabled() bool 


Disabled returns whether the entry is disabled or read-only. 


Implements: fyne.Disableable 


func (*Entry) DoubleTapped 


func (e *Entry) DoubleTapped(p *fyne.PointEvent) 
DoubleTapped is called when this entry has been double tapped so we should select text below the pointer 


Implements: fyne.DoubleTappable 


func (*Entry) DragEnd 


func (e *Entry) DragEnd() 
DragEnd is called at end of a drag event. 


Implements: fyne.Draggable 


func (*Entry) Dragged 


func (e *Entry) Dragged(d *fyne.DragEvent) 


Dragged is called when the pointer moves while a button is held down. It updates the selection 
accordingly. 


Implements: fyne.Draggable 
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func (*Entry) Enable 


func (e *Entry) Enable() 
Enable this widget, updating any style or features appropriately. 


Implements: fyne.Disableable 


func (*Entry) ExtendBaseWidget 


func (e *Entry) ExtendBaseWidget (wid fyne.Widget) 


ExtendBase Widget is used by an extending widget to make use of Base Widget functionality. 


func (*Entry) FocusGained 


func (e *Entry) FocusGained () 
FocusGained is called when the Entry has been given focus. 


Implements: fyne.Focusable 


func (*Entry) FocusLost 


func (e *Entry) FocusLost () 
FocusLost is called when the Entry has had focus removed. 


Implements: fyne.Focusable 


func (*Entry) Hide 


func (e *Entry) Hide () 
Hide hides the entry. 


Implements: fyne.Widget 


func (*Entry) KeyDown 


func (e *Entry) KeyDown(key *fyne.KeyEvent) 


KeyDown handler for keypress events - used to store shift modifier state for text selection 


Implements: desktop.Keyable 
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func (*Entry) KeyUp 


func (e *Entry) KeyUp(key *fyne.KeyEvent) 


KeyUp handler for key release events - used to reset shift modifier state for text selection 


Implements: desktop.Keyable 


func (*Entry) Keyboard 


func (e *Entry) Keyboard() mobile.KeyboardType 
Keyboard implements the Keyboardable interface 


Implements: mobile.Keyboardable 


func (*Entry) MinSize 


func (e *Entry) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below. 


Implements: fyne.Widget 


func (*Entry) MouseDown 


func (e *Entry) MouseDown(m *desktop.MouseEvent) 


MouseDown called on mouse click, this triggers a mouse click which can move the cursor, update the 
existing selection (if shift is held), or start a selection dragging operation. 


Implements: desktop.Mouseable 


func (*Entry) MouseUp 


func (e *Entry) MouseUp(m *desktop.MouseEvent) 


MouseUp called on mouse release If a mouse drag event has completed then check to see if it has resulted 
in an empty selection, if so, and if a text select key isnat held, then disable selecting 


Implements: desktop.Mouseable 


func (*Entry) SelectedText 


func (e *Entry) SelectedText() string 


SelectedText returns the text currently selected in this Entry. If there is no selection it will return the 
empty string. 
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func (*Entry) SetMinRows Visible 


func (e *Entry) SetMinRowsVisible(count int) 


SetMinRows Visible forces a multi-line entry to show count number of rows without scrolling. This is 
not a validation or requirement, it just impacts the minimum visible size. Use this carefully as Fyne apps 
can run on small screens so you may wish to add a scroll container if this number is high. Default is 3. 


Since: 2.2 


func (*Entry) SetOnValidationChanged 


func (e *Entry) SetOnValidationChanged(callback func(error) ) 


SetOnValidationChanged is intended for parent widgets or containers to hook into the validation. The 
function might be overwritten by a parent that cares about child validation (e.g. widget.Form). 


func (*Entry) SetPlaceHolder 


func (e *Entry) SetPlaceHolder (text string) 


SetPlaceHolder sets the text that will be displayed if the entry is otherwise empty 


func (*Entry) SetText 


func (e *Entry) SetText (text string) 


SetText manually sets the text of the Entry to the given text value. 


func (*Entry) Set ValidationError 


func (e *Entry) SetValidationError(err error) 


SetValidationError manually updates the validation status until the next input change 


func (*Entry) Tapped 


func (e *Entry) Tapped(ev *fyne.PointEvent) 


Tapped is called when this entry has been tapped. We update the cursor position in device-specific 
callbacks (MouseDown() and TouchDown()). 


Implements: fyne.Tappable 


func (*Entry) TappedSecondary 


func (e *Entry) TappedSecondary(pe *fyne.PointEvent) 


TappedSecondary is called when right or alternative tap is invoked. 
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Opens the PopUpMenu with Paste item to paste text from the clipboard. 


Implements: fyne.SecondaryTappable 


func (*Entry) TouchCancel 


func (e *Entry) TouchCancel (*mobile.TouchEvent) 


TouchCancel is called when this entry gets a touch cancel event on mobile device (app was removed from 
focus). 


Since: 2.1 
Implements: mobile.Touchable 


func (*Entry) TouchDown 


func (e *Entry) TouchDown(ev *mobile.TouchEvent) 
TouchDown is called when this entry gets a touch down event on mobile device, we ensure we have focus. 


Since: 2.1 
Implements: mobile.Touchable 


func (*Entry) TouchUp 


func (e *Entry) TouchUp (*mobile.TouchEvent) 
TouchUp is called when this entry gets a touch up event on mobile device. 


Since: 2.1 
Implements: mobile.Touchable 


func (*Entry) TypedKey 


func (e *Entry) TypedKey (key *fyne.KeyEvent) 
TypedKey receives key input events when the Entry widget is focused. 


Implements: fyne.Focusable 


func (*Entry) TypedRune 


func (e *Entry) TypedRune(r rune) 
TypedRune receives text input events when the Entry widget is focused. 


Implements: fyne.Focusable 


4609 


func (*Entry) TypedShortcut 


func (e *Entry) TypedShortcut (shortcut fyne.Shortcut) 
TypedShortcut implements the Shortcutable interface 


Implements: fyne.Shortcutable 


func (*Entry) Unbind 


func (e *Entry) Unbind() 


Unbind disconnects any configured data source from this Entry. The current value will remain at the last 
value of the data source. 


Since: 2.0 


func (*Entry) Validate 


func (e *Entry) Validate() error 
Validate validates the current text in the widget 
Tags: 
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Fyne API "widget.FileIcon" 


widget.FileIcon 


import "fyne.io/fyne/v2/widget" 


Usage 


type FileIcon 


type FileIcon struct { 
BaseWidget 


// Deprecated: Selection is now handled externally. 
Selected bool 
URI fyne.URI 


} 
FileIcon is an adaption of widget.Icon for showing files and folders 


Since: 1.4 


func NewFileIcon 


func NewFileIcon(uri fyne.URI) *FileIcon 


NewFilelIcon takes a filepath and creates an icon with an overlaid label using the detected mimetype and 
extension 


Since: 1.4 


func (*FileIcon) CreateRenderer 


func (i *FileIcon) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
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func (*FileIcon) MinSize 


func (i *FileIcon) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below 


func (*FileIcon) SetSelected 


func (i *FileIcon) SetSelected(selected bool) 


SetSelected makes the file look like it is selected. 


Deprecated: Selection is now handled externally. 


func (*FileIcon) SetURI 


func (i *FileIcon) SetURI (uri fyne.URI) 
SetURI changes the URI and makes the icon reflect a different file 
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widget.Form 


import "fyne.io/fyne/v2/widget" 


Usage 


type Form 

type Form struct { 
BaseWidget 
Items [] *FormItem 
OnSubmit func() ‘json:"-"* 
OnCancel func() ‘json:"-"* 


SubmitText string 
CancelText string 


} 


Form widget is two column grid where each row has a label and a widget (usually an input). The last row 
of the grid will contain the appropriate form control buttons if any should be shown. Setting OnSubmit 
will set the submit button to be visible and call back the function when tapped. Setting OnCancel will do 
the same for a cancel button. If you change OnSubmit/OnCancel after the form is created and rendered, 
you need to call Refresh() to update the form with the correct buttons. Setting OnSubmit/OnCancel to nil 
will remove the buttons. 

func NewForm 


func NewForm(items ...*FormItem) *Form 


NewForm creates a new form widget with the specified rows of form items and (if any of them should be 
shown) a form controls row at the bottom 


func (*Form) Append 


func (f *Form) Append(text string, widget fyne.CanvasObject) 
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Append adds a new row to the form, using the text as a label next to the specified Widget 


func (*Form) AppendItem 
func (f *Form) AppendItem(item *FormItem) 
AppendItem adds the specified row to the end of the Form 


func (*Form) CreateRenderer 


func (f *Form) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Form) Disable 


func (f *Form) Disable() 
Disable disables submitting this form. 


Since: 2.1 


func (*Form) Disabled 


func (f *Form) Disabled() bool 


Disabled returns whether submitting the form is disabled. Note that, if the form fails validation, the submit 
button may be disabled even if this method returns true. 


Since: 2.1 


func (*Form) Enable 


func (f *Form) Enable () 


Enable enables submitting this form. 


Since: 2.1 


func (*Form) MinSize 
func (f *Form) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below 


func (*Form) Refresh 


func (f *Form) Refresh () 
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Refresh updates the widget state when requested. 


func (*Form) SetOnValidationChanged 


func (f *Form) SetOnValidationChanged(callback func (error) ) 


SetOnValidationChanged is intended for parent widgets or containers to hook into the validation. The 
function might be overwritten by a parent that cares about child validation (e.g. widget.Form) 


func (*Form) Validate 


func (f *Form) Validate() error 
Validate validates the entire form and returns the first error that is encountered. 
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Fyne API "widget.FormItem" 


widget.FormItem 


import "fyne.io/fyne/v2/widget" 


Usage 


type FormItem 
type FormItem struct { 
Text string 
Widget fyne.CanvasObject 
// Since: 2.0 
HintText string 
} 
FormlItem provides the details for a row in a form 
func NewFormItem 
func NewFormItem(text string, widget fyne.CanvasObject) *FormItem 
NewFormltem creates a new form item with the specified label text and input widget 
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Fyne API "widget.Hyperlink"' 


widget.Hyperlink 


import "fyne.io/fyne/v2/widget" 


Usage 
type Hyperlink 


type Hyperlink struct { 
BaseWidget 
Text string 
URL *url.URL 
Alignment fyne.TextAlign // The alignment of the Text 
Wrapping fyne.TextWrap // The wrapping of the Text 
TextStyle fyne.TextStyle // The style of the hyperlink text 


// OnTapped overrides the default ‘fyne.OpenURL* call when the link is tapped 


// 
// Since: 2.2 
OnTapped func() ‘json:"-"* 


} 


Hyperlink widget is a text component with appropriate padding and layout. When clicked, the default web 
browser should open with a URL 


func NewHyperlink 


func NewHyperlink (text string, url *url.URL) *Hyperlink 


NewHyperlink creates a new hyperlink widget with the set text content 


func NewHyperlinkWithStyle 


func NewHyperlinkWithStyle(text string, url *url.URL, alignment fyne.TextAlign, style fyne.TextStyle) *Hyperlink 


NewHyperlinkWithStyle creates a new hyperlink widget with the set text content 
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func (*Hyperlink) CreateRenderer 


func (hl *Hyperlink) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Hyperlink) Cursor 


func (hl *Hyperlink) Cursor() desktop.Cursor 


Cursor returns the cursor type of this widget 


func (*Hyperlink) FocusGained 


func (hl *Hyperlink) FocusGained() 


FocusGained is a hook called by the focus handling logic after this object gained the focus. 


func (*Hyperlink) FocusLost 


func (hl *Hyperlink) FocusLost () 


FocusLost is a hook called by the focus handling logic after this object lost the focus. 


func (*Hyperlink) MinSize 


func (hl *Hyperlink) MinSize() fyne.Size 


MinSize returns the smallest size this widget can shrink to 


func (*Hyperlink) MouseIn 


func (hl *Hyperlink) MouseIn(*desktop.MouseEvent) 


Mouseln is a hook that is called if the mouse pointer enters the element. 


func (*Hyperlink) MouseMoved 


func (hl *Hyperlink) MouseMoved (*desktop.MouseEvent ) 


MouseMoved is a hook that is called if the mouse pointer moved over the element. 


func (*Hyperlink) MouseOut 


func (hl *Hyperlink) MouseOut () 


MouseOut is a hook that is called if the mouse pointer leaves the element. 
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func (*Hyperlink) Refresh 


func (hl *Hyperlink) Refresh () 
Refresh triggers a redraw of the hyperlink. 


Implements: fyne.Widget 


func (*Hyperlink) Resize 


func (hl *Hyperlink) Resize(size fyne.Size) 


Resize sets a new size for the hyperlink. Note this should not be used if the widget is being managed by a 
Layout within a Container. 


func (*Hyperlink) SetText 


func (hl *Hyperlink) SetText (text string) 


SetText sets the text of the hyperlink 


func (*Hyperlink) SetURL 


func (hl *Hyperlink) SetURL(url *url.URL) 


SetURL sets the URL of the hyperlink, taking in a URL type 


func (*Hyperlink) SetURLFromString 


func (hl *Hyperlink) SetURLFromString(str string) error 


SetURLFromString sets the URL of the hyperlink, taking in a string type 


func (*Hyperlink) Tapped 


func (hl *Hyperlink) Tapped(*fyne.PointEvent) 


Tapped is called when a pointer tapped event is captured and triggers any change handler 


func (*Hyperlink) TypedKey 


func (hl *Hyperlink) TypedKey(ev *fyne.KeyEvent) 


TypedKey is a hook called by the input handling logic on key events if this object is focused. 


func (*Hyperlink) TypedRune 


func (hl *Hyperlink) TypedRune (rune) 
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TypedRune is a hook called by the input handling logic on text input events if this object is focused. 
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Fyne API "widget.HyperlinkSegment" 


widget.HyperlinkSegment 


import "fyne.io/fyne/v2/widget" 


Usage 


type HyperlinkSegment 


type HyperlinkSegment struct { 
Alignment fyne.TextAlign 
Text string 
URL *url.URL 
} 
HyperlinkSegment represents a hyperlink within a rich text widget. 


Since: 2.1 


func (*HyperlinkSegment) Inline 
func (h *HyperlinkSegment) Inline() bool 
Inline returns true as hyperlinks are inside other elements. 


func (*HyperlinkSegment) Select 


func (h *HyperlinkSegment) Select (begin, end fyne.Position) 


Select tells the segment that the user is selecting the content between the two positions. 


func (*HyperlinkSegment) SelectedText 


func (h *HyperlinkSegment) SelectedText() string 


SelectedText should return the text representation of any content currently selected through the Select call. 
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func (*HyperlinkSegment) Textual 


func (h *HyperlinkSegment) Textual() string 


Textual returns the content of this segment rendered to plain text. 


func (*HyperlinkSegment) Unselect 


func (h *HyperlinkSegment) Unselect () 


Unselect tells the segment that the user is has cancelled the previous selection. 


func (*HyperlinkSegment) Update 


func (h *HyperlinkSegment) Update(o fyne.CanvasObject) 


Update applies the current state of this hyperlink segment to an existing visual. 


func (*HyperlinkSegment) Visual 


func (h *HyperlinkSegment) Visual() fyne.CanvasObject 
Visual returns the hyperlink widget required to render this segment. 
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widget.Icon 


import "fyne.io/fyne/v2/widget" 


Usage 


type Icon 


type Icon struct { 
BaseWidget 


Resource fyne.Resource // The resource for this icon 


} 


Icon widget is a basic image component that loadas its resource to match the theme. 


func NewlIcon 


func NewIcon(res fyne.Resource) *Icon 


Newlcon returns a new icon widget that displays a themed icon resource 


func (*Icon) CreateRenderer 


func (i *Icon) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Icon) MinSize 


func (i *Icon) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 
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func (*Icon) SetResource 


func (i *Icon) SetResource(res fyne.Resource) 


SetResource updates the resource rendered in this icon widget 
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Fyne API "'widget.Label" 


widget.Label 


import "fyne.io/fyne/v2/widget" 


Usage 
type Label 


type Label struct { 

BaseWidget 
Text string 
Alignment fyne.TextAlign // The alignment of the Text 
Wrapping fyne.TextWrap // The wrapping of the Text 
TextStyle fyne.TextStyle // The style of the label text 


} 


Label widget is a label component with appropriate padding and layout. 


func NewLabel 


func NewLabel (text string) *Label 


NewLabel creates a new label widget with the set text content 


func NewLabelWithData 


func NewLabelWithData(data binding.String) *Label 
NewLabelWithData returns an Label widget connected to the specified data source. 


Since: 2.0 


func NewLabelWithStyle 


func NewLabelWithStyle(text string, alignment fyne.TextAlign, style fyne.TextStyle) *Label 
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NewLabelWithStyle creates a new label widget with the set text content 


func (*Label) Bind 


func (1 *Label) Bind(data binding.String) 


Bind connects the specified data source to this Label. The current value will be displayed and any changes 
in the data will cause the widget to update. 


Since: 2.0 


func (*Label) CreateRenderer 


func (l *Label) CreateRenderer() fyne.WidgetRenderer 
CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Label) ExtendBaseWidget 


func (1 *Label) ExtendBaseWidget (w fyne.Widget) 


ExtendBaseWidget is used by an extending widget to make use of Base Widget functionality. 


func (*Label) MinSize 


func (1 *Label) MinSize() fyne.Size 
MinSize returns the size that this label should not shrink below. 


Implements: fyne.Widget 


func (*Label) Refresh 


func (1 *Label) Refresh () 
Refresh triggers a redraw of the label. 


Implements: fyne.Widget 


func (*Label) Resize 


func (1 *Label) Resize(s fyne.Size) 


Resize sets a new size for the label. This should only be called if it is not in a container with a layout 
manager. 


Implements: fyne.Widget 
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func (*Label) SetText 


func (1 *Label) SetText (text string) 


SetText sets the text of the label 


func (*Label) Unbind 


func (1 *Label) Unbind() 


Unbind disconnects any configured data source from this Label. The current value will remain at the last 
value of the data source. 


Since: 2.0 
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Fyne API "widget.List" 


widget.List 


import "fyne.io/fyne/v2/widget" 


Usage 


type List 

type List struct { 
BaseWidget 
Length func() int ‘4son:"—" 
CreateItem func() fyne.CanvasObject ‘4yson:"—"* 
UpdateItem func(id ListItemID, item fyne.CanvasObject) ‘json:"-"* 
OnSelected func(id ListItemID) *Json:"-"* 
OnUnselected func(id ListItemID) ‘jJson:"-"% 


List is a widget that pools list items for performance and lays the items out in a vertical direction inside of 
a scroller. List requires that all items are the same size. 


Since: 1.4 


func NewList 


func NewList (length func() int, createItem func() fyne.CanvasObject, updateItem func(ListItemID, fyne.CanvasObject)) *List 


NewList creates and returns a list widget for displaying items in a vertical layout with scrolling and 
caching for performance. 


Since: 1.4 


func NewListWithData 


func NewListWithData(data binding.DataList, createItem func() fyne.CanvasObject, updateItem func(binding.DataItem, fyne.CanvasObject)) *List 


NewListWithData creates a new list widget that will display the contents of the provided data. 
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Since: 2.0 


func (*List) CreateRenderer 


func (1 *List) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer. 
func (*List) MinSize 
func (1 *List) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below. 


func (*List) Resize 


func (1 *List) Resize(s fyne.Size) 
Resize is called when this list should change size. We refresh to ensure invisible items are drawn. 


func (*List) ScrollTo 


func (1 *List) ScrollTo(id ListItemID) 
ScrollTo scrolls to the item represented by id 


Since: 2.1 


func (*List) ScrollToBottom 


func (1 *List) ScrollToBottom () 
ScrollToBottom scrolls to the end of the list 


Since: 2.1 


func (*List) ScrolIToTop 


func (1 *List) ScrollToTop() 
ScrollToTop scrolls to the start of the list 


Since: 2.1 


func (*List) Select 


func (1 *List) Select (id ListItemID) 


Select add the item identified by the given ID to the selection. 
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func (*List) Unselect 


func (1 *List) Unselect (id ListItemID) 

Unselect removes the item identified by the given ID from the selection. 
func (*List) UnselectAll 

func (1 *List) UnselectAll () 

UnselectAll removes all items from the selection. 


Since: 2.1 
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Fyne API "widget.ListItemID" 


widget.ListItemID 


import "fyne.io/fyne/v2/widget" 


Usage 


type ListItemID 
type ListItemID = int 
ListItemID uniquely identifies an item within a list. 
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Fyne API "widget.ListSegment"’ 


widget.ListSegment 


import "fyne.io/fyne/v2/widget" 


Usage 


type ListSegment 


type ListSegment struct { 
Items []RichTextSegment 
Ordered bool 

} 


ListSegment includes an itemised list with the content set using the Items field. 
Since: 2.1 

func (*ListSegment) Inline 

func (1 *ListSegment) Inline() bool 

Inline returns false as a list should be in a block. 

func (*ListSegment) Segments 

func (1 *ListSegment) Segments() []RichTextSegment 

Segments returns the segments required to draw bullets before each item 


func (*ListSegment) Select 


func (1 *ListSegment) Select (_, fyne.Position) 


Select does nothing for a list container. 
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func (*ListSegment) SelectedText 


func (1 *ListSegment) SelectedText() string 


SelectedText returns the empty string for this list. 

func (*ListSegment) Textual 

func (1 *ListSegment) Textual() string 

Textual returns no content for a list as the content is in sub-segments. 
func (*ListSegment) Unselect 

func (1 *ListSegment) Unselect () 

Unselect does nothing for a list container. 

func (*ListSegment) Update 

func (1 *ListSegment) Update (fyne.CanvasObject) 
Update doesnt need to change a list visual. 

func (*ListSegment) Visual 

func (1 *ListSegment) Visual() fyne.CanvasObject 
Visual returns no additional elements for this segment. 
Tags: 
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© [List My Applip 5023} 


Fyne API "widget.Menu" 


widget.Menu 


import "fyne.io/fyne/v2/widget" 


Usage 


type Menu 


type Menu struct { 
BaseWidget 


Items []fyne.CanvasObject 
OnDismiss func () 
} 
Menu is a widget for displaying a fyne.Menu. 
func NewMenu 
func NewMenu(menu *fyne.Menu) *Menu 
NewMent creates a new Menu. 
func (*Menu) ActivateLastSubmenu 


func (m *Menu) ActivateLastSubmenu() bool 


ActivateLastSubmenu finds the last active menu item traversing through the open submenus and activates 
its submenu if any. It returns t rue if there was a submenu and it was activated and false elsewhere. 
Activating a submenu does show it and activate its first item. 


func (*Menu) ActivateNext 
func (m *Menu) ActivateNext () 


ActivateNext activates the menu item following the currently active menu item. If there is no menu item 
active, it activates the first menu item. If there is no menu item after the current active one, it does nothing. 
If a submenu is open, it delegates the activation to this submenu. 
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func (*Menu) ActivatePrevious 


func (m *Menu) ActivatePrevious () 


ActivatePrevious activates the menu item preceding the currently active menu item. If there is no menu 
item active, it activates the last menu item. If there is no menu item before the current active one, it does 
nothing. If a submenu is open, it delegates the activation to this submenu. 


func (*Menu) CreateRenderer 


func (m *Menu) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer returns a new renderer for the menu. 


Implements: fyne.Widget 


func (*Menu) DeactivateChild 


func (m *Menu) DeactivateChild() 


DeactivateChild deactivates the active menu item and hides its submenu if any. 


func (*Menu) DeactivateLastSubmenu 


func (m *Menu) DeactivateLastSubmenu() bool 


DeactivateLastSubmenu finds the last open submenu traversing through the open submenus, deactivates 
its active item and hides it. This also deactivates any submenus of the deactivated submenu. It returns 
true if there was a submenu open and closed and false elsewhere. 


func (*Menu) Dismiss 


func (m *Menu) Dismiss () 


Dismiss dismisses the menu by dismissing and hiding the active child and performing OnDismiss. 


func (*Menu) MinSize 


func (m *Menu) MinSize() fyne.Size 
MinSize returns the minimal size of the menu. 


Implements: fyne.Widget 


func (*Menu) Refresh 


func (m *Menu) Refresh () 


Refresh updates the menu to reflect changes in the data. 
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Implements: fyne.Widget 


func (*Menu) Tapped 


func (m *Menu) Tapped(*fyne.PointEvent) 
Tapped catches taps on separators and the menu background. It doesnat perform any action. 


Implements: fyne.Tappable 


func (*Menu) TriggerLast 


func (m *Menu) TriggerLast () 
TriggerLast finds the last active menu item traversing through the open submenus and triggers it. 
Tags: 
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widget.Orientation 


import "fyne.io/fyne/v2/widget" 


Usage 

type Orientation 

type Orientation int 

Orientation controls the horizontal/vertical layout of a widget 
const ( 


Horizontal Orientation 
Vertical Orientation 


) 
Orientation constants to control widget layout 
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Fyne API "'widget.ParagraphSegment"' 


widget.ParagraphSegment 


import "fyne.io/fyne/v2/widget" 


Usage 


type ParagraphSegment 


type ParagraphSegment struct { 
Texts []RichTextSegment 
} 


ParagraphSegment wraps a number of text elements in a paragraph. It is similar to using a list of text 
elements when the final style is RichTextStyleParagraph. 


Since: 2.1 


func (*ParagraphSegment) Inline 


func (p *ParagraphSegment) Inline() bool 


Inline returns false as a paragraph should be in a block. 


func (*ParagraphSegment) Segments 


func (p *ParagraphSegment) Segments() []RichTextSegment 


Segments returns the list of text elements in this paragraph. 


func (*ParagraphSegment) Select 


func (p *ParagraphSegment) Select(_, _ fyne.Position) 


Select does nothing for a paragraph container. 
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func (*ParagraphSegment) SelectedText 


func (p *ParagraphSegment) SelectedText() string 


SelectedText returns the empty string for this paragraph container. 
func (*ParagraphSegment) Textual 
func (p *ParagraphSegment) Textual() string 


Textual returns no content for a paragraph container. 


func (*ParagraphSegment) Unselect 


func (p *ParagraphSegment) Unselect () 


Unselect does nothing for a paragraph container. 


func (*ParagraphSegment) Update 


func (p *ParagraphSegment) Update(fyne.CanvasObject) 


Update doesnt need to change a paragraph container. 


func (*ParagraphSegment) Visual 


func (p *ParagraphSegment) Visual() fyne.CanvasObject 
Visual returns the no extra elements. 
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Fyne API "'widget.PopUp" 


widget.PopUp 


import "fyne.io/fyne/v2/widget" 


Usage 
type PopUp 


type PopUp struct { 
BaseWidget 


Content fyne.CanvasObject 
Canvas fyne.Canvas 


} 


PopUp is a widget that can float above the user interface. It wraps any standard elements with padding and 
a shadow. If it is modal then the shadow will cover the entire canvas it hovers over and block interactions. 


func NewModalPopUp 
func NewModalPopUp(content fyne.CanvasObject, canvas fyne.Canvas) *PopUp 


NewModalPopUp creates a new popUp for the specified content and displays it on the passed canvas. A 
modal PopUp blocks interactions with underlying elements, covered with a semi-transparent overlay. 


func NewPopUp 
func NewPopUp(content fyne.CanvasObject, canvas fyne.Canvas) *PopUp 
NewPopUp creates a new popUp for the specified content and displays it on the passed canvas. 


func (*PopUp) CreateRenderer 


func (p *PopUp) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
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func (*PopUp) Hide 

func (p *PopUp) Hide () 

Hide this widget, if it was previously visible 

func (*“PopUp) MinSize 

func (p *PopUp) MinSize() fyne.Size 

MinSize returns the size that this widget should not shrink below 
func (*“PopUp) Move 

func (p *PopUp) Move(pos fyne.Position) 


Move the widget to a new position. A PopUp position is absolute to the top, left of its canvas. For PopUp 
this actually moves the content so checking Position() will not return the same value as is set here. 


func (*PopUp) Resize 


func (p *PopUp) Resize(size fyne.Size) 


Resize changes the size of the PopUpas content. PopUps always have the size of their canvas, but this call 
updates the size of the content portion. 


Implements: fyne.Widget 
func (*PopUp) Show 
func (p *PopUp) Show () 


Show this pop-up as overlay if not already shown. 


func (*PopUp) ShowAtPosition 


func (p *PopUp) ShowAtPosition(pos fyne.Position) 
ShowAtPosition shows this pop-up at the given position. 
func (*PopUp) Tapped 

func (p *PopUp) Tapped(_ *fyne.PointEvent) 


Tapped is called when the user taps the popUp background - if not modal then dismiss this widget 
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func (*PopUp) TappedSecondary 


func (p *PopUp) TappedSecondary(_ *fyne.PointEvent) 


TappedSecondary is called when the user right/alt taps the background - if not modal then dismiss this 
widget 
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Fyne API "widget.PopUpMenu" 


widget.PopUpMenu 


import "fyne.io/fyne/v2/widget" 


Usage 
type PopUpMenu 


type PopUpMenu struct { 
*Menu 


} 


PopUpMenu is a Menu which displays itself in an OverlayContainer. 


func NewPopUpMenu 


func NewPopUpMenu(menu *fyne.Menu, c fyne.Canvas) *PopUpMenu 
NewPopUpMenut creates a new, reusable popup menu. You can show it using ShowAtPosition. 


Since: 2.0 


func (*“PopUpMenu) FocusGained 


func (p *PopUpMenu) FocusGained () 
FocusGained is triggered when the object gained focus. For the pop-up menu it does nothing. 


Implements: fyne.Focusable 


func (*“PopUpMenu) FocusLost 


func (p *PopUpMenu) FocusLost () 
FocusLost is triggered when the object lost focus. For the pop-up menu it does nothing. 


Implements: fyne.Focusable 
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func (*“PopUpMenu) Hide 


func (p *PopUpMenu) Hide () 
Hide hides the pop-up menu. 


Implements: fyne.Widget 


func (*“PopUpMenu) Move 


func (p *PopUpMenu) Move(pos fyne.Position) 


Move moves the pop-up menu. The position is absolute because pop-up menus are shown in an overlay 
which covers the whole canvas. 


Implements: fyne.Widget 


func (*“PopUpMenu) Resize 


func (p *PopUpMenu) Resize(size fyne.Size) 


Resize changes the size of the pop-up menu. 


Implements: fyne.Widget 


func (*PopUpMenu) Show 


func (p *PopUpMenu) Show() 

Show makes the pop-up menu visible. 

Implements: fyne.Widget 

func (*PopUpMenu) ShowAtPosition 

func (p *PopUpMenu) ShowAtPosition(pos fyne.Position) 
ShowAtPosition shows the pop-up menu at the specified position. 


func (*PopUpMenu) TypedKey 


func (p *PopUpMenu) TypedKey(e *fyne.KeyEvent) 


TypedKey handles key events. It allows keyboard control of the pop-up menu. 


Implements: fyne.Focusable 
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func (*“PopUpMenu) TypedRune 


func (p *PopUpMenu) TypedRune (rune) 
TypedRune handles text events. For pop-up menus this does nothing. 


Implements: fyne.Focusable 
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Fyne API "widget.ProgressBar"' 


widget.ProgressBar 


import "fyne.io/fyne/v2/widget" 


Usage 


type ProgressBar 


type ProgressBar struct { 
BaseWidget 


Min, Max, Value float64 


// TextFormatter can be used to have a custom format of progress text. 
// Tf set, it overrides the percentage readout and runs each time the value updates. 


// 
// Since: 1.4 
TextFormatter func() string ‘json:"-"*% 


} 


ProgressBar widget creates a horizontal panel that indicates progress 


func NewProgressBar 


func NewProgressBar() *ProgressBar 


NewProgressBar creates a new progress bar widget. The default Min is 0 and Max is 1, Values set should 
be between those numbers. The display will convert this to a percentage. 


func NewProgressBarWithData 


func NewProgressBarWithData(data binding.Float) *ProgressBar 
NewProgressBarWithData returns a progress bar connected with the specified data source. 


Since: 2.0 
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func (*ProgressBar) Bind 


func (p *ProgressBar) Bind(data binding.Float) 


Bind connects the specified data source to this ProgressBar. The current value will be displayed and any 
changes in the data will cause the widget to update. 


Since: 2.0 


func (*ProgressBar) CreateRenderer 


func (p *ProgressBar) CreateRenderer() fyne.WidgetRenderer 
CreateRenderer is a private method to Fyne which links this widget to its renderer 
func (*ProgressBar) MinSize 

func (p *ProgressBar) MinSize() fyne.Size 

MinSize returns the size that this widget should not shrink below 

func (*ProgressBar) SetValue 

func (p *ProgressBar) SetValue(v float64) 


SetValue changes the current value of this progress bar (from p.Min to p.Max). The widget will be 
refreshed to indicate the change. 


func (*ProgressBar) Unbind 
func (p *ProgressBar) Unbind() 


Unbind disconnects any configured data source from this ProgressBar. The current value will remain at 
the last value of the data source. 


Since: 2.0 
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Fyne API "widget.ProgressBarInfinite"' 


widget.ProgressBar Infinite 


import "fyne.io/fyne/v2/widget" 


Usage 


type ProgressBarInfinite 
type ProgressBariInfinite struct { 


BaseWidget 
} 


ProgressBarInfinite widget creates a horizontal panel that indicates waiting indefinitely An infinite 
progress bar loops 0% -> 100% repeatedly until StopQ) is called 


func NewProgressBarInfinite 


func NewProgressBarInfinite() *ProgressBarInfinite 


NewProgressBarInfinite creates a new progress bar widget that loops indefinitely from 0% -> 100% 
SetValue() is not defined for infinite progress bar To stop the looping progress and set the progress bar to 
100%, call ProgressBarInfinite.StopQ) 


func (*ProgressBarInfinite) CreateRenderer 


func (p *ProgressBarInfinite) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*ProgressBarInfinite) Hide 


func (p *ProgressBarInfinite) Hide () 


Hide this widget, if it was previously visible 
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func (*ProgressBarInfinite) MinSize 


func (p *ProgressBarInfinite) MinSize() fyne.Size 
MinSize returns the size that this widget should not shrink below 
func (*ProgressBarInfinite) Running 

func (p *ProgressBariInfinite) Running() bool 


Running returns the current state of the infinite progress animation 


func (*ProgressBarInfinite) Show 


func (p *ProgressBarInfinite) Show() 


Show this widget, if it was previously hidden 


func (*ProgressBarInfinite) Start 


func (p *ProgressBarInfinite) Start () 


Start the infinite progress bar animation 


func (*ProgressBarInfinite) Stop 


func (p *ProgressBarInfinite) Stop() 
Stop the infinite progress bar animation 
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widget.RadioGroup 


import "fyne.io/fyne/v2/widget" 


Usage 
type RadioGroup 


type RadioGroup struct { 
DisableableWidget 
Horizontal bool 
Required bool 
OnChanged func(string) ‘json:"-"* 
Options []string 
Selected string 
} 


RadioGroup widget has a list of text labels and checks check icons next to each. Changing the selection 
(only one can be selected) will trigger the changed func. 


Since: 1.4 


func NewRadioGroup 


func NewRadioGroup (options []string, changed func(string)) *RadioGroup 
NewRadioGroup creates a new radio group widget with the set options and change handler 


Since: 1.4 


func (*RadioGroup) Append 


func (r *RadioGroup) Append(option string) 


Append adds a new option to the end of a RadioGroup widget. 
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func (*RadioGroup) CreateRenderer 


func (r *RadioGroup) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
func (*RadioGroup) MinSize 
func (r *RadioGroup) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 


func (*RadioGroup) Refresh 


func (r *RadioGroup) Refresh () 
Refresh causes this widget to be redrawn in itas current state. 


Implements: fyne.CanvasObject 


func (*RadioGroup) SetSelected 


func (r *RadioGroup) SetSelected(option string) 
SetSelected sets the radio option, it can be used to set a default option. 
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Fyne API "widget.RichText"' 


widget.RichText 


import "fyne.io/fyne/v2/widget" 


Usage 
type RichText 


type RichText struct { 
BaseWidget 
Segments []RichTextSegment 
Wrapping fyne.TextWrap 
Scroll widget .ScrollDirection 


} 
RichText represents the base element for a rich text-based widget. 


Since: 2.1 


func NewRichText 


func NewRichText (segments ...RichTextSegment) *RichText 


NewRichText returns a new RichText widget that renders the given text and segments. If no segments are 
specified it will be converted to a single segment using the default text settings. 


Since: 2.1 


func NewRichTextFromMarkdown 


func NewRichTextFromMarkdown (content string) *RichText 
NewRichTextFromMarkdown configures a RichText widget by parsing the provided markdown content. 


Since: 2.1 
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func NewRichTextWithText 


func NewRichTextWithText (text string) *RichText 


NewRichTextWithText returns a new RichText widget that renders the given text. The string will be 
converted to a single text segment using the default text settings. 


Since: 2.1 


func (*RichText) CreateRenderer 


func (t *RichText) CreateRenderer() fyne.WidgetRenderer 
CreateRenderer is a private method to Fyne which links this widget to its renderer 
func (*RichText) MinSize 

func (t *RichText) MinSize() fyne.Size 


MinSize calculates the minimum size of a rich text widget. This is based on the contained text with a 
standard amount of padding added. 


func (*RichText) ParseMarkdown 
func (t *RichText) ParseMarkdown(content string) 


ParseMarkdown allows setting the content of this RichText widget from a markdown string. It will replace 
the content of this widget similarly to SetText, but with the appropriate formatting. 


func (*RichText) Refresh 


func (t *RichText) Refresh () 
Refresh triggers a redraw of the rich text. 


Implements: fyne.Widget 


func (*RichText) Resize 


func (t *RichText) Resize(size fyne.Size) 


Resize sets a new size for the rich text. This should only be called if it is not in a container with a layout 
manager. 


Implements: fyne.Widget 
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func (*RichText) String 


func (t *RichText) String() string 
String returns the text widget buffer as string 
Tags: 
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widget.RichTextBlock 


import "fyne.io/fyne/v2/widget" 


Usage 
type RichTextBlock 


type RichTextBlock interface { 
Segments() []RichTextSegment 
} 
RichTextBlock is an extension of a text segment that contains other segments 


Since: 2.1 
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widget.RichTextSegment 


import "fyne.io/fyne/v2/widget" 


Usage 


type RichTextSegment 


type RichTextSegment interface { 
Inline() bool 


Textual() string 
Update (fyne.CanvasObject) 
Visual() fyne.CanvasObject 


Select (posl, pos2 fyne.Position) 
SelectedText() string 
Unselect () 
} 
RichTextSegment describes any element that can be rendered in a RichText widget. 
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Fyne API "widget.RichTextStyle"' 


widget.RichTextStyle 


import "fyne.io/fyne/v2/widget" 


Usage 
type RichTextStyle 


type RichTextStyle struct { 
Alignment fyne.TextAlign 
ColorName fyne.ThemeColorName 


Inline bool 
SizeNam fyne.ThemeSizeNam 
TextStyle fyne.TextStyl 


} 
RichTextStyle describes the details of a text object inside a RichText widget. 
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Fyne API ''widget.Select'' 


widget.Select 


import "fyne.io/fyne/v2/widget" 


Usage 


type Select 


type Select struct { 
DisableableWidget 


// Alignment sets the text alignment of the select and its list of options. 
// 

// Since: 2.1 

Alignment fyne.TextAlign 

Selected string 

Options [] string 

PlaceHolder string 

OnChanged func(string) ‘json:"-"* 


} 

Select widget has a list of options, with the current one shown, and triggers an event func when clicked 
func NewSelect 

func NewSelect (options []string, changed func(string)) *Select 

NewSelect creates a new select widget with the set list of options and changes handler 


func (*Select) ClearSelected 


func (s *Select) ClearSelected() 


ClearSelected clears the current option of the select widget. After clearing the current option, the Select 
widgetas PlaceHolder will be displayed. 
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func (*Select) CreateRenderer 


func (s *Select) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 


func (*Select) FocusGained 


func (s *Select) FocusGained() 
FocusGained is called after this Select has gained focus. 


Implements: fyne.Focusable 


func (*Select) FocusLost 


func (s *Select) FocusLost () 
FocusLost is called after this Select has lost focus. 


Implements: fyne.Focusable 


func (*Select) Hide 


func (s *Select) Hide () 
Hide hides the select. 


Implements: fyne.Widget 


func (*Select) MinSize 


func (s *Select) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 


func (*Select) MouseIn 


func (s *Select) MouseIn(*desktop.MouseEvent) 


Mouseln is called when a desktop pointer enters the widget 


func (*Select) MouseMoved 


func (s *Select) MouseMoved (*desktop.MouseEvent) 


MouseMoved is called when a desktop pointer hovers over the widget 
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func (*Select) MouseOut 


func (s *Select) MouseOut () 


MouseOut is called when a desktop pointer exits the widget 


func (*Select) Move 


func (s *Select) Move(pos fyne.Position) 
Move changes the relative position of the select. 


Implements: fyne.Widget 


func (*Select) Resize 


func (s *Select) Resize(size fyne.Size) 


Resize sets a new size for a widget. Note this should not be used if the widget is being managed by a 
Layout within a Container. 


func (*Select) SelectedIndex 


func (s *Select) SelectedIndex() int 


SelectedIndex returns the index value of the currently selected item in Options list. It will return -1 if there 
is no selection. 


func (*Select) SetSelected 


func (s *Select) SetSelected(text string) 


SetSelected sets the current option of the select widget 


func (*Select) SetSelectedIndex 


func (s *Select) SetSelectedIndex (index int) 


SetSelectedIndex will set the Selected option from the value in Options list at index position. 


func (*Select) Tapped 


func (s *Select) Tapped(*fyne.PointEvent) 


Tapped is called when a pointer tapped event is captured and triggers any tap handler 
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func (*Select) TypedKey 


func (s *Select) TypedKey (event *fyne.KeyEvent) 
TypedKey is called if a key event happens while this Select is focused. 


Implements: fyne.Focusable 


func (*Select) TypedRune 


func (s *Select) TypedRune(_ rune) 
TypedRune is called if a text event happens while this Select is focused. 


Implements: fyne.Focusable 
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widget.SelectEntry 


import "fyne.io/fyne/v2/widget" 


Usage 


type SelectEntry 


type SelectEntry struct { 
Entry 


} 


SelectEntry is an input field which supports selecting from a fixed set of options. 


func NewSelectEntry 


func NewSelectEntry (options []string) *SelectEntry 


NewSelectEntry creates a SelectEntry. 


func (*SelectEntry) CreateRenderer 


func (e *SelectEntry) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer returns a new renderer for this select entry. 


Implements: fyne.Widget 


func (*SelectEntry) Disable 


func (e *SelectEntry) Disable () 
Disable this widget so that it cannot be interacted with, updating any style appropriately. 


Implements: fyne.DisableableWidget 
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func (*SelectEntry) Enable 


func (e *SelectEntry) Enable () 
Enable this widget, updating any style or features appropriately. 


Implements: fyne.DisableableWidget 


func (*SelectEntry) MinSize 


func (e *SelectEntry) MinSize() fyne.Size 
MinSize returns the minimal size of the select entry. 


Implements: fyne.Widget 


func (*SelectEntry) Move 


func (e *SelectEntry) Move(pos fyne.Position) 
Move changes the relative position of the select entry. 


Implements: fyne.Widget 


func (*SelectEntry) Resize 


func (e *SelectEntry) Resize(size fyne.Size) 


Resize changes the size of the select entry. 


Implements: fyne.Widget 


func (*SelectEntry) SetOptions 


func (e *SelectEntry) SetOptions(options []string) 
SetOptions sets the options the user might select from. 
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Fyne API ''widget.Separator" 


widget.Separator 


import "fyne.io/fyne/v2/widget" 


Usage 


type Separator 


type Separator struct { 
BaseWidget 
} 


Separator is a widget for displaying a separator with themeable color. 


Since: 1.4 


func NewSeparator 


func NewSeparator() *Separator 
NewSeparator creates a new separator. 


Since: 1.4 


func (*Separator) CreateRenderer 


func (s *Separator) CreateRenderer() fyne.WidgetRenderer 
CreateRenderer returns a new renderer for the separator. 


Implements: fyne.Widget 


func (*Separator) MinSize 


func (s *Separator) MinSize() fyne.Size 
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MinSize returns the minimal size of the separator. 


Implements: fyne.Widget 
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Fyne API "widget.SeparatorSegment"' 


widget.SeparatorSegment 


import "fyne.io/fyne/v2/widget" 


Usage 


type SeparatorSegment 


type SeparatorSegment struct { 
} 


SeparatorSegment includes a horizontal separator in a rich text widget. 


Since: 2.1 


func (*SeparatorSegment) Inline 

func (s *SeparatorSegment) Inline() bool 

Inline returns false as a separator should be full width. 

func (*SeparatorSegment) Select 

func (s *SeparatorSegment) Select(_, _ fyne.Position) 
Select does nothing for a separator. 


func (*SeparatorSegment) SelectedText 


func (s *SeparatorSegment) SelectedText() string 


SelectedText returns the empty string for this separator. 
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func (*SeparatorSegment) Textual 


func (s *SeparatorSegment) Textual() string 


Textual returns no content for a separator element. 


func (*SeparatorSegment) Unselect 


func (s *SeparatorSegment) Unselect () 


Unselect does nothing for a separator. 


func (*SeparatorSegment) Update 


func (s *SeparatorSegment) Update(fyne.CanvasObject) 


Update doesnt need to change a separator visual. 


func (*SeparatorSegment) Visual 


func (s *SeparatorSegment) Visual() fyne.CanvasObject 
Visual returns the separator element for this segment. 
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widget.Slider 


import "fyne.io/fyne/v2/widget" 


Usage 
type Slider 


type Slider struct { 
BaseWidget 


Value float64 
Min float64 
Max float64 
Step float64 
Orientation Orientation 
OnChanged func (float 64) 
} 
Slider is a widget that can slide between two fixed values. 
func NewSlider 
func NewSlider(min, max float64) *Slider 
NewSlider returns a basic slider. 
func NewSliderWithData 
func NewSliderWithData(min, max float64, data binding.Float) *Slider 


NewSliderWithData returns a slider connected with the specified data source. 


Since: 2.0 
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func (*Slider) Bind 


func (s *Slider) Bind(data binding.Float) 


Bind connects the specified data source to this Slider. The current value will be displayed and any changes 
in the data will cause the widget to update. User interactions with this Slider will set the value into the data 
source. 


Since: 2.0 


func (*Slider) CreateRenderer 


func (s *Slider) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer links this widget to its renderer. 


func (*Slider) DragEnd 


func (s *Slider) DragEnd() 
DragEnd function. 


func (*Slider) Dragged 


func (s *Slider) Dragged(e *fyne.DragEvent) 

Dragged function. 

func (*Slider) MinSize 

func (s *Slider) MinSize() fyne.Size 

MinSize returns the size that this widget should not shrink below 


func (*Slider) SetValue 


func (s *Slider) SetValue(value float64) 


SetValue updates the value of the slider and clamps the value to be within the range. 
func (*Slider) Unbind 
func (s *Slider) Unbind() 


Unbind disconnects any configured data source from this Slider. The current value will remain at the last 
value of the data source. 


Since: 2.0 
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Fyne API "widget.Table"' 


widget.Table 


import "fyne.io/fyne/v2/widget" 


Usage 


type Table 

type Table struct { 
BaseWidget 
Length func() (int, int) “json. "-—"> 
CreateCell func() fyne.CanvasObject ‘jJson:"-"* 
UpdateCell func(id TableCellID, template fyne.CanvasObject) ‘json:"-"* 
OnSelected func(id TableCellID) ‘sons "s"* 
OnUnselected func(id TableCellID) ‘Jsons'—'* 


} 


Table widget is a grid of items that can be scrolled and a cell selected. Itas performance is provided by 
caching cell templates created with CreateCell and re-using them with UpdateCell. The size of the content 
rows/columns is returned by the Length callback. 


Since: 1.4 


func NewTable 


func NewTable(length func() (int, int), create func() fyne.CanvasObject, update func(TableCellID, fyne.CanvasObject)) *Table 


NewTable returns a new performant table widget defined by the passed functions. The first returns the 
data size in rows and columns, second parameter is a function that returns cell template objects that can be 
cached and the third is used to apply data at specified data location to the passed template CanvasObject. 


Since: 1.4 
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func (*Table) CreateRenderer 


func (t *Table) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer returns a new renderer for the table. 
Implements: fyne.Widget 

func (*Table) ScrollTo 

func (t *Table) ScrollTo(id TableCellID) 


ScrollTo will scroll to the given cell without changing the selection. Attempting to scroll beyond the limits 
of the table will scroll to the edge of the table instead. 


Since: 2.1 

func (*Table) ScrollToBottom 

func (t *Table) ScrollToBottom() 

ScrolToBottom scrolls to the last row in the table 

Since: 2.1 

func (*Table) ScrollToLeading 

func (t *Table) ScrollToLeading() 

ScrollToLeading scrolls horizontally to the leading edge of the table 
Since: 2.1 

func (*Table) ScrollToTop 

func (t *Table) ScrollToTop() 

ScrollToTop scrolls to the first row in the table 

Since: 2.1 

func (*Table) ScrollToTrailing 

func (t *Table) ScrollToTrailing() 

ScrollToTrailing scrolls horizontally to the trailing edge of the table 


Since: 2.1 
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func (*Table) Select 


func (t *Table) Select (id TableCellID) 

Select will mark the specified cell as selected. 

func (*Table) SetColumnWidth 

func (t *Table) SetColumnWidth(id int, width float32) 


SetColumnWidth supports changing the width of the specified column. Columns normally take the width 
of the template cell returned from the CreateCell callback. The width parameter uses the same units as a 
fyne.Size type and refers to the internal content width not including the divider size. 


Since: 1.4.1 
func (*Table) Unselect 
func (t *Table) Unselect (id TableCellID) 


Unselect will mark the cell provided by id as unselected. 


func (*Table) UnselectAll 


func (t *Table) UnselectAll () 
UnselectAll will mark all cells as unselected. 


Since: 2.1 
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widget.TableCellID 


import "fyne.io/fyne/v2/widget" 


Usage 
type TableCellID 


type TableCellID struct { 
Row int 
Col int 

} 


TableCellID is a type that represents a cellas position in a table based on itas row and column location. 
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Fyne API "widget.TextGrid"' 


widget. TextGrid 


import "fyne.io/fyne/v2/widget" 


Usage 
type TextGrid 


type TextGrid struct { 

BaseWidget 

Rows []TextGridRow 

ShowLineNumbers bool 

ShowWhitespace bool 

TabWidth int // If set to 0 the fyne.DefaultTabWidth is used 
} 


TextGrid is a monospaced grid of characters. This is designed to be used by a text editor, code preview or 
terminal emulator. 


func NewTextGrid 

func NewTextGrid() *TextGrid 

NewTextGrid creates a new empty TextGrid widget. 

func NewTextGridFromString 

func NewTextGridFromString(content string) *TextGrid 
NewTextGridFromString creates a new TextGrid widget with the specified string content. 


func (*TextGrid) CreateRenderer 


func (t *TextGrid) CreateRenderer() fyne.WidgetRenderer 
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CreateRenderer is a private method to Fyne which links this widget to itas renderer 


func (*TextGrid) MinSize 


func (t *TextGrid) MinSize() fyne.Size 


MinSize returns the smallest size this widget can shrink to 


func (*TextGrid) Resize 


func (t *TextGrid) Resize(size fyne.Size) 


Resize is called when this widget changes size. We should make sure that we refresh cells. 
func (*TextGrid) Row 
func (t *TextGrid) Row(row int) TextGridRow 


Row returns a copy of the content in a specified row as a TextGridRow. If the index is out of bounds it 
returns an empty row object. 


func (*TextGrid) RowText 
func (t *TextGrid) RowText (row int) string 


RowText returns a string representation of the content at the row specified. If the index is out of bounds it 
returns an empty string. 


func (*TextGrid) SetCell 

func (t *TextGrid) SetCell(row, col int, cell TextGridCell) 
SetCell sets a grid data to the cell at named row and column. 

func (*TextGrid) SetRow 

func (t *TextGrid) SetRow(row int, content TextGridRow) 


SetRow updates the specified row of the gridas contents using the specified content and style and then 
refreshes. If the row is beyond the end of the current buffer it will be expanded. Tab characters are not 
padded with spaces. 


func (*TextGrid) SetRowStyle 
func (t *TextGrid) SetRowStyle(row int, style TextGridStyle) 


SetRowStyle sets a grid style to all the cells cell at the specified row. Any cells in this row with their own 
style will override this value when displayed. 


4916 


func (*TextGrid) SetRune 


func (t *TextGrid) SetRune(row, col int, r rune) 

SetRune sets a character to the cell at named row and column. 

func (*TextGrid) SetStyle 

func (t *TextGrid) SetStyle(row, col int, style TextGridStyle) 

SetStyle sets a grid style to the cell at named row and column. 

func (*TextGrid) SetStyleRange 

func (t *TextGrid) SetStyleRange(startRow, startCol, endRow, endCol int, style TextGridStyle) 


SetStyleRange sets a grid style to all the cells between the start row and column through to the end row 
and column. 


func (*TextGrid) SetText 
func (t *TextGrid) SetText (text string) 


SetText updates the buffer of this textgrid to contain the specified text. New lines and columns will be 
added as required. Lines are separated by a\na. The grid will use default text style and any previous 
content and style will be removed. Tab characters are padded with spaces to the next tab stop. 


func (*TextGrid) Text 


func (t *TextGrid) Text() string 


Text returns the contents of the buffer as a single string (with no style information). It reconstructs the 
lines by joining with a \n character. Tab characters have padded spaces removed. 
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widget. TextGridCell 


import "fyne.io/fyne/v2/widget" 


Usage 
type TextGridCell 


type TextGridCell struct { 
Rune rune 
Style TextGridStyle 
} 


TextGridCell represents a single cell in a text grid. It has a rune for the text content and a style associated 
with it. 
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widget.TextGridRow 


import "fyne.io/fyne/v2/widget" 


Usage 


type TextGridRow 


type TextGridRow struct { 
Cells []TextGridCell 
Style TextGridStyle 
} 


TextGridRow represents a row of cells cell in a text grid. It contains the cells for the row and an optional 
style. 
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Fyne API ''widget.TextGridStyle" 


widget.TextGridStyle 


import "fyne.io/fyne/v2/widget" 


Usage 
type TextGridStyle 


type TextGridStyle interface { 
TextColor() color.Color 
BackgroundColor() color.Color 


} 


TextGridStyle defines a style that can be applied to a TextGrid cell. 


var ( 
// TextGridStyleDefault is a default style for test grid cells 
TextGridStyleDefault TextGridStyle 
// TextGridStyleWhitespace is the style used for whitespace characters, if enabled 
TextGridStyleWhitespace TextGridStyle 

) 
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Fyne API "widget.TextSegment" 


widget.TextSegment 


import "fyne.io/fyne/v2/widget" 


Usage 


type TextSegment 


type TextSegment struct { 
Style RichTextStyl 
Text string 


} 
TextSegment represents the styling for a segment of rich text. 


Since: 2.1 


func (*TextSegment) Inline 


func (t *TextSegment) Inline() bool 


Inline should return true if this text can be included within other elements, or false if it creates a new 
block. 


func (*TextSegment) Select 


func (t *TextSegment) Select (begin, end fyne.Position) 
Select tells the segment that the user is selecting the content between the two positions. 


func (*TextSegment) SelectedText 


func (t *TextSegment) SelectedText() string 


SelectedText should return the text representation of any content currently selected through the Select call. 
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func (*TextSegment) Textual 


func (t *TextSegment) Textual() string 


Textual returns the content of this segment rendered to plain text. 
func (*TextSegment) Unselect 
func (t *TextSegment) Unselect () 


Unselect tells the segment that the user is has cancelled the previous selection. 


func (*TextSegment) Update 


func (t *TextSegment) Update(o fyne.CanvasObject) 


Update applies the current state of this text segment to an existing visual. 


func (*TextSegment) Visual 


func (t *TextSegment) Visual() fyne.CanvasObject 
Visual returns the graphical elements required to render this segment. 
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Fyne API "'widget.Toolbar" 


widget.Toolbar 


import "fyne.io/fyne/v2/widget" 


Usage 


type Toolbar 


type Toolbar struct { 
BaseWidget 
Items []ToolbarItem 
} 


Toolbar widget creates a horizontal list of tool buttons 


func NewToolbar 

func NewToolbar (items ...ToolbarItem) *Toolbar 
NewToolbar creates a new toolbar widget. 

func (*Toolbar) Append 

func (t *Toolbar) Append(item ToolbarItem) 
Append a new ToolbarlItem to the end of this Toolbar 


func (*Toolbar) CreateRenderer 


func (t *Toolbar) CreateRenderer() fyne.WidgetRenderer 


CreateRenderer is a private method to Fyne which links this widget to its renderer 
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func (*Toolbar) MinSize 


func (t *Toolbar) MinSize() fyne.Size 


MinSize returns the size that this widget should not shrink below 


func (*Toolbar) Prepend 


func (t *Toolbar) Prepend(item ToolbarItem) 
Prepend a new Toolbarltem to the start of this Toolbar 
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widget. ToolbarAction 


import "fyne.io/fyne/v2/widget" 


Usage 


type ToolbarAction 

type ToolbarAction struct { 
Icon fyne.Resource 
OnActivated func() ‘json:"-"* 


} 


ToolbarAction is push button style of ToolbarItem 


func NewToolbarAction 


func NewToolbarAction(icon fyne.Resource, onActivated func()) *ToolbarAction 


NewToolbarAction returns a new push button style Toolbarltem 


func (*ToolbarAction) SetIcon 


func (t *ToolbarAction) SetIcon(icon fyne.Resource) 
SetIcon updates the icon on a Toolbarltem 


Since: 2.2 


func (*ToolbarAction) ToolbarObject 


func (t *ToolbarAction) ToolbarObject() fyne.CanvasObject 
ToolbarObject gets a button to render this ToolbarAction 
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import "fyne.io/fyne/v2/widget" 


Usage 


type ToolbarItem 


type ToolbarItem interface { 
ToolbarObject() fyne.CanvasObject 
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Toolbarltem represents any interface element that can be added to a toolbar 
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Fyne API "'widget.ToolbarSeparator"' 


widget. ToolbarSeparator 


import "fyne.io/fyne/v2/widget" 


Usage 


type ToolbarSeparator 


type ToolbarSeparator struct { 
} 


ToolbarSeparator is a thin, visible divide that can be added to a Toolbar. This is typically used to assist 
visual grouping of ToolbarlItems. 


func NewToolbarSeparator 


func NewToolbarSeparator() *ToolbarSeparator 


NewToolbarSeparator returns a new separator item for a Toolbar to assist with Toolbarltem grouping 


func (*ToolbarSeparator) ToolbarObject 


func (t *ToolbarSeparator) ToolbarObject() fyne.CanvasObject 
ToolbarObject gets the visible line object for this ToolbarSeparator 
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Fyne API "'widget.ToolbarSpacer"' 


widget.ToolbarSpacer 


import "fyne.io/fyne/v2/widget" 


Usage 


type ToolbarSpacer 


type ToolbarSpacer struct { 
} 


ToolbarSpacer is a blank, stretchable space for a toolbar. This is typically used to assist layout if you wish 
some left and some right aligned items. Space will be split evebly amongst all the spacers on a toolbar. 


func NewToolbarSpacer 


func NewToolbarSpacer() *ToolbarSpacer 


NewToolbarSpacer returns a new spacer item for a Toolbar to assist with ToolbarItem alignment 


func (*ToolbarSpacer) ToolbarObject 


func (t *ToolbarSpacer) ToolbarObject() fyne.CanvasObject 
ToolbarObject gets the actual spacer object for this ToolbarSpacer 
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[Mouseable] [p 4085] 
[MouseButton)[p 4094] 
[MouseEvent][p 4104] 
e [StandardCursoy|[p 4113] 
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5007 


© [TouchEvent|[p 4168) 
© [iriver/software][p 41771 

[package software][p 4177] 
O flayout][p 4187] 

© [package layout] [p 4187] 
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[TextGridStylel[p 4936] 
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[Toolbar] [p 4955] 
[RoolbarAction] |p 4965] 
[Foolbarltem]{p 49751 
[ToolbarSeparator|[p 4984] 
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e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
@ [TreeNodeID][p 5014] 
@ [List My Appl[p 5023] 
Fyne API "widget.Tree" 


widget.Tree 


import "fyne.io/fyne/v2/widget" 


Usage 


type Tree 


type Tree struct { 
BaseWidget 
Root TreeNodeID 


ChildUIDs func(uid TreeNodeID) (c []TreeNodeID) "* // Return a sorted slice of Children TreeNodeIDs for the given Node TreeNodeID 
CreateNode func (branch bool) (o fyne.CanvasObject) // Return a CanvasObject that can represent a Branch (if branch is true), or a Leaf (if branch is false 
IsBranch func (uid TreeNodeID) (ok bool) // Return true if the given TreeNodeID represents a Branch 


OnBranchClosed func(uid TreeNodeID) when a Branch is closed 
OnBranchOpened func (uid TreeNodeID 
OnSelected func (uid TreeNodeID) when the Node with the given TreeNodeID is selected 

OnUnselected func (uid TreeNodeID) lled when the Node with the given TreeNodeID is unselected 

Updat eNode func (uid TreeNodeID, branch bool, node fyne.CanvasObject) ‘json:"-"* // Called to update the given CanvasObject to represent the data at the given TreeNodeID 


when a Branch is opened 


Tree widget displays hierarchical data. Each node of the tree must be identified by a Unique TreeNodeID. 


Since: 1.4 


func NewTree 


func NewTree(childUIDs func(TreeNodeID) []TreeNodeID, isBranch func(TreeNodeID) bool, create func(bool) fyne.CanvasObject, update func(TreeNodeID, bool, fyne.CanvasObject)) *Tree 


NewTree returns a new performant tree widget defined by the passed functions. childUIDs returns the 
child TreeNodeIDs of the given node. isBranch returns true if the given node is a branch, false if it is a 
leaf. create returns a new template object that can be cached. update is used to apply data at specified data 
location to the passed template CanvasObject. 


Since: 1.4 


func NewTreeWithStrings 


func NewTreeWithStrings (data map[string][]string) (t *Tree) 


NewTreeWithStrings creates a new tree with the given string map. Data must contain a mapping for the 
root, which defaults to empty string (44). 
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Since: 1.4 


func (*Tree) CloseAllBranches 


func (t *Tree) CloseAllBranches () 


CloseAllBranches closes all branches in the tree. 


func (*Tree) CloseBranch 


func (t *Tree) CloseBranch(uid TreeNodelID) 


CloseBranch closes the branch with the given TreeNodeID. 


func (*Tree) CreateRenderer 


func (t *Tree) CreateRenderer() fyne.WidgetRenderer 

CreateRenderer is a private method to Fyne which links this widget to its renderer. 
func (*Tree) IsBranchOpen 

func (t *Tree) IsBranchOpen(uid TreeNodeID) bool 

IsBranchOpen returns true if the branch with the given TreeNodeID is expanded. 
func (*Tree) MinSize 

func (t *Tree) MinSize() fyne.Size 

MinSize returns the size that this widget should not shrink below. 

func (*Tree) OpenAllBranches 

func (t *Tree) OpenAllBranches () 

OpenAllBranches opens all branches in the tree. 

func (*Tree) OpenBranch 

func (t *Tree) OpenBranch(uid TreeNodeID) 

OpenBranch opens the branch with the given TreeNodeID. 


func (*Tree) Resize 


func (t *Tree) Resize(size fyne.Size) 


Resize sets a new size for a widget. 
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func (*Tree) ScrollTo 


func (t *Tree) ScrollTo(uid TreeNodeID) 
ScrollTo scrolls to the node with the given id. 


Since 2.1 


func (*Tree) ScrollToBottom 


func (t *Tree) ScrollToBottom () 
ScrollToBottom scrolls to the bottom of the tree. 


Since 2.1 


func (*Tree) ScrollToTop 


func (t *Tree) ScrollToTop() 
ScrollToTop scrolls to the top of the tree. 


Since 2.1 


func (*Tree) Select 


func (t *Tree) Select (uid TreeNodeID) 


Select marks the specified node to be selected. 


func (*Tree) ToggleBranch 


func (t *Tree) ToggleBranch(uid string) 


ToggleBranch flips the state of the branch with the given TreeNodeID. 


func (*Tree) Unselect 


func (t *Tree) Unselect (uid TreeNodeID) 


Unselect marks the specified node to be not selected. 


func (*Tree) UnselectAll 


func (t *Tree) UnselectAll1 () 
UnselectAll sets all nodes to be not selected. 


Since: 2.1 
Tags: 
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© Layout and widget size 
© Customisation 


@ {API Documentation|[p ??] 
© {Upgrade to v2.2|[p 2665] 
O |Fyne API v2.2|[p 21] 


package Tynd|[p 21] 
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[AnimationCurve][p 2685] 


[p 2694] 

[p 2704] 
(p 2713] 

[p 2722] 

[p 2732] 
[p 2742 

[p 2751] 

[p 2762] 

[p 2771] 


[p 2780] 


Disableable|[p 2789] 


DoubleTappable][p 2798] 


[DragEvend|[p 2807] 
[Praggable]ip 2816] 
[Driver][p 2825] 
[Focusable||p 2834] 
[HardwareKey|[p 2843] 


KeyboardShortcut|[p 2852] 


[KeyEvend|{p 2861] 
[p 2870] 
[KeyName]|p 2879] 
[Layout|[p 2891] 
[Legacy Theme] [p 2900] 
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[Notification][p 2956] 
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[Size][p 3115] 
[StaticResource][p 3125] 
[Storage][p 3135] 
[String Validato|[p 3144] 
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[URI|[p 3243] 
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© [package dialog] [p 3912] 

© [ColorPickerDialog][p 3923] 

© [ConfirmDialog]{p 3933) 
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© [EntryDialog]{p 3953] 

e 
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[FileDialog][p 3963] 
[ProgressDialog][p 3974] 
© [ProgressinfiniteDialog][p 3984] 
© [ifiver/desktop|[p 3994] 
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[Button|[p 4499] 
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[CustomPextGridStylel[p 4577] 
[p 4586] 
[p 4595] 
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[Form] [p 4621] 

[p 4632| 
[Hyperlink] [p 4641) 
[HyperlinkSegmend|{p 4653) 
[p 4663] 

[Label] [p 4673] 
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e [ToolbarSpacer|[p 4993] 
e [Tree|[p 5002] 
e [TreeNodeID][p 5014] 
@ [List My App][p 5023] 
Fyne API "'widget.TreeNodeID"' 


widget. TreeNodeID 


import "fyne.io/fyne/v2/widget" 


Usage 
type TreeNodeID 


type TreeNodeID = string 


TreeNodelID represents the unique id of a tree node. 
Tags: 
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Frequently Asked Questions 


As the Fyne toolkit presents a different approach to the traditional design of GUI tookits in some ways we 
have compiled this selection of answers to frequently asked questions. The content is grouped into the 
following areas. 


@ Layout and widget size 
@ Theme and customisation 


If you have more questions please[get in touch] [p ??]. 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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GUI Overview 


Graphical applications are often more complicated to create than web based or command line applications. 
Fyne changes this by utilizing the great design of Go to make building beautiful graphical applications 
simple and fast. 


For a graphical application to work we need to create a window and ask the app to run. Doing so will start 
the event handling code that responds to user input and updates the screen as our code runs. 


This example creates a new application with a single window with the title AHelloa. Inside this window we 
place a single label containing the text dHello Fyne!a. 


package main 


import ( 
"fyne.io/fyne/v2/app" 
"fyne.io/fyne/v2/widget" 
) 
func main() { 
myApp := app.New() 
myWindow := myApp.NewWindow ("Hello") 


myWindow.SetContent (widget .NewLabel ("Hello Fyne!") ) 


myWindow. ShowAndRun () 
} 


Once the window content is set we show it and run the application (Window. ShowAndRun () isa 
shortcut for Window. Show() && App.Run () ). After calling Run() or ShowAndRun() our application 
will run and the function will return after the window has been closed. 


If you like the Fyne toolkit please consider|sponsoring] [p ??] our work. 
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Redirecting... 
[Click here if you are not redirected][p 5052] 
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Canvas and CanvasObject 


In Fyne a Canvas is the area which an application is drawn within. Each window has a canvas which you 
can access with Window. Canvas () but usually you will find functions on Window that avoid 
accessing the canvas. 


Everything that can be drawn in Fyne is a type of CanvasOb ject. The example here opens a new 
window and then shows different types of primitive graphical element by setting the content of the 
window canvas. There are many ways that each type of object can be customised as shown with the text 
and circle examples. 


As well as changing the content shown using Canvas.SetContent () it is possible to change the 
content that is currently visible. If, for example, you change the FillColour of a rectangle you can 
request a refresh of this existing component using rect .Refresh(). 


package main 


import ( 
"image/color" 
"time" 


"fyne.io/fyne/v2" 

"fyne.io/fyne/v2/app" 

"fyne.io/fyne/v2/canvas" 
) 


func main() { 
myApp := app.New() 
myWindow := myApp.NewWindow ("Canvas") 
myCanvas := myWindow.Canvas () 


blue := color.NRGBA{R: 0, G: 0, B: 180, A: 255} 
rect := canvas.NewRectangle (blue) 
myCanvas.SetContent (rect) 


go func() { 
time.Sleep (time.Second) 
green := color.NRGBA{R: 0, G: 180, B: 0, A: 255} 


rect.FillColor = green 
rect .Refresh () 


1O 


myWindow.Resize(fyne.NewSize(100, 100) ) 
myWindow. ShowAndRun () 
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We can draw many different drawing elements in the same way, such as circle and text. 


func setContentToText(c fyne.Canvas) { 
green := color.NRGBA{R: 0, G: 180, B: 0, A: 255} 
text := canvas.NewText ("Text", green) 
text.TextStyle.Bold = tru 
c.SetContent (text) 


func setContentToCircle(c fyne.Canvas) { 
red := color.NRGBA{R: Oxff, G: 0x33, B: 0x33, A: Oxff} 
circle := canvas.NewCircle(color.White) 
circle.StrokeWidth = 4 
circle.StrokeColor = red 
c.SetContent (circle) 


Widget 


A fyne.Widget is a special type of canvas object that has interactive elements associated with it. In 
widgets the logic is separate from the way that it looks (also called the WidgetRenderer). 


Widgets are also types of CanvasOb ject and so we can set the content of our window to a single 
widget. See how we create a new widget .Entry and set it as the content of the window in this 
example. 


package main 


import ( 
"fyne.io/fyne/v2/app" 
"fyne.io/fyne/v2/widget" 
) 
func main() { 
myApp := app.New() 
myWindow := myApp.NewWindow ("Widget") 


myWindow.SetContent (widget .NewEntry () ) 
myWindow. ShowAndRun () 
} 


If you like the Fyne toolkit please consider[sponsoring] [p ??] our work. 
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